NamedRange.NoteText Метод (2007 System)
Обновлен: Ноябрь 2007
Возвращает или задает примечание ячейки, связанное с ячейкой в левом верхнем углу элемента управления NamedRange.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)
Синтаксис
'Декларация
Public Function NoteText ( _
Text As Object, _
Start As Object, _
Length As Object _
) As String
'Применение
Dim instance As NamedRange
Dim Text As Object
Dim Start As Object
Dim Length As Object
Dim returnValue As String
returnValue = instance.NoteText(Text, _
Start, Length)
public 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.
В этом примере демонстрируется настройка уровня документа.
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
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();
}
}
Разрешения
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.