XmlMappedRange.NoteText-Methode

Artikel
05/07/2013

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

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

string NoteText(
    Object Text,
    Object Start,
    Object Length
)

Parameter

Text
Typ: System.Object
Der dem Hinweis hinzuzufügende Text (max. 255 Zeichen).Der Text wird beginnend an Position Start eingefügt und ersetzt dabei Length Zeichen des vorhandenen Hinweises.Wenn dieses Argument weggelassen wird, gibt diese Methode den aktuellen Text des Hinweises beginnend an Position Start für Length Zeichen zurück.

Start
Typ: System.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
Typ: System.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 die Anzahl der Zeichen den Wert 255 zwischen Start und dem Hinweisende überschreitet, gibt diese Methode nur 255 Zeichen zurück.

Rückgabewert

Typ: System.String

Hinweise

Zellhinweise wurden durch Bereichskommentare ersetzt.Weitere Informationen hierzu finden Sie in den Ausführungen zum Comment-Objekt.

Um einen Hinweis hinzuzufügen, der mehr als 255 Zeichen enthält, verwenden Sie die Methode zuerst, um die ersten 255 Zeichen anzugeben. Anschließend verwenden Sie die Methode erneut, um den noch fehlenden Rest des Hinweises anzuhängen (jeweils max. 255 Zeichen).

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird die NoteText-Methode verwendet, um einem XmlMappedRange einen Hinweis hinzufügen. Danach wird der Benutzer aufgefordert, den Hinweis mithilfe der ClearNotes-Eigenschaft zu entfernen.In diesem Codebeispiel wird davon ausgegangen, dass das aktuelle Arbeitsblatt einen XmlMappedRange mit dem Namen CustomerLastNameCell enthält.

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

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();
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XmlMappedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über