XmlMappedRange.NoteText(Object, Object, Object) 方法

定义

命名空间:

Microsoft.Office.Tools.Excel

程序集:

Microsoft.Office.Tools.Excel.dll

获取或设置与 XmlMappedRange 控件相关联的单元格说明。

public string NoteText (object Text, object Start, object Length);

abstract member NoteText : obj * obj * obj -> string

Public Function NoteText (Optional Text As Object, Optional Start As Object, Optional Length As Object) As String

参数

Text

Object

要添加到说明中的文本（最多 255 个字符）。 文本从位置 Start开始插入，替换 Length 现有笔记的字符。 如果省略此参数，此方法将返回字符从位置 StartLength 开始的笔记的当前文本。

Start

Object

所设置或返回的文本的起始位置。 如果省略此参数，则此方法将从第一个字符开始。 若要向该注释追加文本，请指定一个比现有注释中字符数大的数字。

Length

Object

要设置或返回的字符数。 如果省略此参数，则 Microsoft Office Excel 将设置或返回从注释的起始位置到末尾的字符（最多 255 个字符）。 如果从 Start 到笔记末尾的字符数超过 255 个字符，则此方法仅返回 255 个字符。

返回

String

示例

下面的代码示例使用 NoteText 方法将注释 XmlMappedRange添加到 ，然后提示用户使用 方法删除注释 ClearNotes 。 此代码示例假定当前工作表包含名为 XmlMappedRangeCustomerLastNameCell的 。

private void SetNote()
{
    this.CustomerLastNameCell.NoteText("This cell contains customer " +
        "last names.");

    if (MessageBox.Show("Remove the note?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearNotes();
    }
}

Private Sub SetNote()
    Me.CustomerLastNameCell.NoteText("This cell contains customer " & _
        "last names.")

    If MessageBox.Show("Remove the note?", "Test", MessageBoxButtons.YesNo) = _
        DialogResult.Yes Then
        Me.CustomerLastNameCell.ClearNotes()
    End If
End Sub

注解

单元格备注已替换为范围注释。 有关详细信息，请参阅 Comment 对象。

若要添加包含超过 255 个字符的注释，请使用此方法一次指定前 255 个字符，然后再次使用它来追加注释的其余部分， (一次) 不超过 255 个字符。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。