NamedRange.NoteText-Methode

Artikel
08/10/2011

Ruft den Zellhinweis ab, der mit der Zelle in der linken oberen Ecke des NamedRange-Steuerelements verknüpft ist, oder legt diesen Hinweis 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 veranschaulicht, wie verschiedene Formatierungs- und Anzeigeeigenschaften eines NamedRange-Steuerelements mit dem Namen NamedRange1 festgelegt werden. Insbesondere wird in diesem Beispiel die NoteText-Methode verwendet, um NamedRange1 einen Hinweis mit dem Text This is a Formatting test hinzuzufügen.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

' <Snippet36>
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

' </Snippet35>

// <Snippet36>
private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test", missing, missing);
    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, missing);
    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();
    }
}
// </Snippet35>

.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

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via