【xlwings api语言参考】Range.NoteText 方法

功能：
返回或设置与区域左上角单元格相关联的单元格注释。 读/写 String。 单元格注释已经替换为区域注释。 有关详细信息，请参阅 Comment 对象。

语法：
rng.NoteText(Text,Start,Length)
rng是一个表示 Range 对象的变量。

参数：
名称 必需/可选 数据类型 说明
Text 可选 字符串 要添加到注释中的文本（不超过 255 个字符）。 注释文本插入的起始位置由 Start 参数指定，并替换现有注释的 Length 字符。 如果省略该参数，此方法将返回注释的当前文本，该注释起始于 Start 位置，长度为 Length 个字符。
Start 可选 数字 设置或返回的文本的起始位置。 如果省略该参数，此方法将第一个字符作为起始位置。 要将文本追加到注释，请指定一个大于现有注释中的字符数的数字。
Length 可选 数字 要设置或返回的字符数。 如果省略该参数，则 Microsoft Excel 将以从现有注释起始位置到注释末尾的长度设置或返回字符（不超过 255 个字符）。 如果从 Start 位置到注释的末尾的字符数超过 255，则此方法只返回 255 个字符。

返回值：
String

注释：
若要添加超过 255 个字符的注释，请先使用此方法指定前 255 个字符，然后再用它为注释追加其余部分（一次不超过 255 个字符）。

示例：
本示例为工作表 Sheet1 上的单元格 A1 设置单元格注释。

sht.api.Range('A1').NoteText('This may change!')