XmlMappedRange.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 kontrolką XmlMappedRange .

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 użyto NoteText metody , aby dodać notatkę do XmlMappedRangeelementu , a następnie monituje użytkownika o usunięcie notatki przy użyciu ClearNotes metody . W tym przykładzie kodu przyjęto założenie, że bieżący arkusz zawiera XmlMappedRange nazwę CustomerLastNameCell.

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

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

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

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.