XmlMappedRange.NoteText(Object, Object, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Tools.Excel

Assembly:: Microsoft.Office.Tools.Excel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen mit dem XmlMappedRange-Steuerelement verknüpften Zellenhinweis ab oder legt diesen fest.

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

Parameter

Text: Object

Der dem Hinweis hinzuzufügende Text (max. 255 Zeichen). Der Text wird ab Position Starteingefügt, wobei Length Zeichen der vorhandenen Notiz ersetzt werden. Wenn dieses Argument weggelassen wird, gibt diese Methode den aktuellen Text der Notiz ab position Startfür Length Zeichen zurück.

Start: Object

Die Anfangsposition für den Text, der festgelegt oder zurückgegeben wird. Wenn dieses Argument weggelassen wird, beginnt diese Methode am ersten Zeichen. Um Text an einen Hinweis anzuhängen, geben Sie eine Zahl an, die größer als die Anzahl der Zeichen im vorhandenen Hinweis ist.

Length: Object

Die Anzahl von Zeichen, die festgelegt oder zurückgegeben werden soll. Wenn dieses Argument weggelassen wird, legt Microsoft Office Excel Zeichen von der Anfangsposition bis zum Hinweisende (max. 255 Zeichen) fest oder gibt diese zurück. Wenn mehr als 255 Zeichen von Start bis zum Ende der Notiz vorhanden sind, gibt diese Methode nur 255 Zeichen zurück.

Gibt zurück

String

Beispiele

Im folgenden Codebeispiel wird die NoteText -Methode verwendet, um eine Notiz zu einer XmlMappedRangehinzuzufügen. Anschließend wird der Benutzer aufgefordert, die Notiz mithilfe der ClearNotes -Methode zu entfernen. In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange namens CustomerLastNameCellenthält.

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

Hinweise

Zellnotizen wurden durch Bereichskommentare ersetzt. Weitere Informationen finden Sie im Comment -Objekt.

Um eine Notiz hinzuzufügen, die mehr als 255 Zeichen enthält, verwenden Sie diese Methode einmal, um die ersten 255 Zeichen anzugeben, und verwenden Sie sie dann erneut, um den Rest der Notiz anzufügen (nicht mehr als 255 Zeichen gleichzeitig).

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Projektmappen.

Gilt für:

Freigeben über