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 символы существующей заметки. Если этот аргумент опущен, этот метод возвращает текущий текст заметки, начиная с позиции Start, для Length символов.

Start

Object

Начальная позиция вставляемого или возвращаемого текста. Если этот аргумент не указывается, этот метод начинается с первого символа. Чтобы присоединить текст к примечанию, укажите число больше количества символов в существующем примечании.

Length

Object

Число вставляемых или возвращаемых символов. Если этот аргумент не указывается, Microsoft Office Excel вставляет или возвращает символы от начальной позиции до конца примечания (не более 255 символов). Если в заметке содержится более 255 символов Start , этот метод возвращает только 255 символов.

Возвращаемое значение

String

Примеры

В следующем примере кода используется NoteText метод для добавления заметки в XmlMappedRange, а затем пользователю предлагается удалить заметку с помощью ClearNotes метода . В этом примере кода предполагается, что текущий лист содержит объект с XmlMappedRange именем CustomerLastNameCell.

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.