NamedRange.NoteText - метод

Статья
08/11/2011

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

Пространство имен: 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.

Примеры

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

В этом примере демонстрируется настройка уровня документа.

' <Snippet36>
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

' </Snippet35>

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

    namedRange1.NoteText("This is a Formatting test", missing, missing);
    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, missing);
    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();
    }
}
// </Snippet35>

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

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

См. также

Ссылки

NamedRange Интерфейс

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

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