NamedRange.NoteText(Object, Object, Object) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Office.Tools.Excel

Zestaw:

Microsoft.Office.Tools.Excel.dll

Pobiera lub ustawia notatkę komórki skojarzona z komórką w lewym górnym rogu kontrolki 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

Parametry

Text

Object

Tekst do dodania do notatki (maksymalnie 255 znaków). Tekst jest wstawiany od pozycji Start, zastępując Length znaki istniejącej notatki. Jeśli ten argument zostanie pominięty, ta metoda zwraca bieżący tekst notatki, zaczynając od pozycji Start, dla Length znaków.

Start

Object

Pozycja początkowa tekstu, który jest ustawiony lub zwracany. Jeśli ten argument zostanie pominięty, ta metoda rozpoczyna się od pierwszego znaku. Aby dołączyć tekst do notatki, określ liczbę większą niż liczba znaków w istniejącej notatce.

Length

Object

Liczba znaków do ustawienia lub zwrócenia. Jeśli ten argument zostanie pominięty, program Microsoft Office Excel ustawia lub zwraca znaki z pozycji początkowej do końca notatki (maksymalnie 255 znaków). Jeśli na końcu notatki jest więcej niż 255 znaków Start , ta metoda zwraca tylko 255 znaków.

Zwraca

String

Przykłady

W poniższym przykładzie kodu pokazano, jak ustawić różne cechy NamedRange formatowania i wyświetlania kontrolki o nazwie NamedRange1. W szczególności w tym przykładzie użyto NoteText metody , aby dodać notatkę do NamedRange1 elementu z tekstem This is a Formatting test.

Ten przykład dotyczy dostosowywania na poziomie dokumentu.

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

Uwagi

Notatki z komórek zostały zastąpione komentarzami zakresu. Aby uzyskać więcej informacji, zobacz Comment obiekt .

Aby dodać notatkę zawierającą więcej niż 255 znaków, użyj tej metody raz, aby określić pierwsze 255 znaków, a następnie użyj jej ponownie, aby dołączyć pozostałą część notatki (nie więcej niż 255 znaków jednocześnie).

Parametry opcjonalne

Aby uzyskać informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach pakietu Office.