NamedRange.NoteText(Object, Object, Object) Metoda

Definice

Obor názvů:

Microsoft.Office.Tools.Excel

Sestavení:

Microsoft.Office.Tools.Excel.dll

Získá nebo nastaví poznámku buňky přidružené k buňce v levém horním rohu NamedRange ovládacího prvku.

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

Text, který se má přidat do poznámky (maximálně 255 znaků). Text se vloží od pozice Starta nahradí Length znaky existující poznámky. Pokud je tento argument vynechán, vrátí tato metoda pro znaky aktuální text poznámky začínající na pozici Start.Length

Start

Object

Počáteční pozice pro text, který je nastaven nebo vrácen. Pokud je tento argument vynechán, tato metoda začíná prvním znakem. Pokud chcete k poznámce přidat text, zadejte číslo větší, než je počet znaků v existující poznámce.

Length

Object

Počet znaků, které mají být nastaveny nebo vráceny. Pokud je tento argument vynechán, microsoft Office Excel nastaví nebo vrátí znaky od počáteční pozice do konce poznámky (až 255 znaků). Pokud je od Start konce poznámky více než 255 znaků, vrátí tato metoda pouze 255 znaků.

Návraty

String

Příklady

Následující příklad kódu ukazuje, jak nastavit různé formátování a vlastnosti zobrazení NamedRange ovládacího prvku s názvem NamedRange1. Konkrétně tento příklad používá metodu NoteText k přidání poznámky s NamedRange1 textem This is a Formatting test.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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

Poznámky

Poznámky k buňce byly nahrazeny komentáři k rozsahu. Další informace najdete v objektu Comment .

Pokud chcete přidat poznámku, která obsahuje více než 255 znaků, použijte tuto metodu jednou k zadání prvních 255 znaků a pak ji znovu použijte k připojení zbytku poznámky (maximálně 255 znaků najednou).

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.