XmlMappedRange.NoteText - метод

Статья
08/11/2011

Возвращает или задает примечание ячейки, связанное с элементом управления XmlMappedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

string NoteText(
    Object Text,
    Object Start,
    Object Length
)

Параметры

Text
Тип: System.Object
Текст, добавляемый в примечание (длиной до 255 символов).Текст вставляется, начиная с позиции Start, заменяя Length символов существующего примечания.Если этот аргумент не указывается, этот метод возвращает текущий текст примечания, начиная с позиции Start, длиной Length символов.

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

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

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

Тип: System.String

Заметки

Примечания ячеек заменены комментариями диапазона. Дополнительные сведения см. в описании объекта Comment.

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

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

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

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

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

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

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

XmlMappedRange Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через