NamedRange.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 den Zellhinweis ab, der mit der Zelle in der linken oberen Ecke des NamedRange-Steuerelements verknüpft ist, oder legt diesen Hinweis 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 veranschaulicht, wie sie eine Vielzahl von Formatierungen und Anzeigeeigenschaften eines NamedRange Steuerelements mit dem Namen NamedRange1festlegen. Insbesondere wird in diesem Beispiel die NoteText -Methode verwendet, um eine Notiz mit dem Text This is a Formatting testhinzuzufügenNamedRange1.

Dieses Beispiel gilt für eine Anpassung auf Dokumentebene.

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

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 (nicht mehr als 255 Zeichen gleichzeitig) hinzuzufügen.

Optionale Parameter

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

Gilt für:

Freigeben über