NamedRange.NoteText(Object, Object, Object) Метод

Определение

Пространство имен:

Microsoft.Office.Tools.Excel

Сборка:

Microsoft.Office.Tools.Excel.dll

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

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

Примеры

В следующем примере кода показано, как задать различные характеристики NamedRange форматирования и отображения элемента управления с именем NamedRange1. В частности, в этом примере используется NoteText метод для добавления заметки к NamedRange1 с текстом This is a Formatting test.

Этот пример предназначен для настройки на уровне документа.

private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test");
    namedRange1.Value2 = "Martha";
    namedRange1.Font.Name = "Verdana";
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
    namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic);
    namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
        true, false, true, false, true, true);

    if (MessageBox.Show("Clear the formatting and notes?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}

Private Sub SetRangeFormats()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.NoteText("This is a Formatting test", , )
    namedRange1.Value2 = "Martha"
    namedRange1.Font.Name = "Verdana"
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
    namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
        Excel.XlColorIndex.xlColorIndexAutomatic, )
    namedRange1.AutoFormat( _
        Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
        True, False, True, False, True, True)

    If MessageBox.Show("Clear the formatting and notes?", _
        "Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
        namedRange1.ClearFormats()
        namedRange1.ClearNotes()
    End If
End Sub

Комментарии

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

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

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

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