Udostępnij za pośrednictwem


Metoda NamedRange.NoteText —

Pobiera lub ustawia skojarzonych z komórki w lewym górnym rogu notatki komórek NamedRange kontroli.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

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

Parametry

  • Text
    Typ: System.Object
    Tekst, aby dodać do notatki (maksymalnie 255 znaków).Tekst jest wstawiany, począwszy od pozycji Start, zastępując Length znaków istniejącej notatki.Jeśli ten argument zostanie pominięty, Metoda ta zwraca bieżący tekst notatki, począwszy od pozycji Start, aby Length znaków.
  • Start
    Typ: System.Object
    Pozycja początkowa dla tekst, który ma wartość lub zwracane.Jeśli ten argument zostanie pominięty, ta metoda rozpoczyna się od pierwszego znaku.Aby dołączyć tekst do notatki, podaj liczbę większą niż liczba znaków w istniejącej notatki.
  • Length
    Typ: System.Object
    Liczba znaków do ustawiania lub zwracane.Jeśli ten argument zostanie pominięty, program Microsoft Office Excel ustawia lub zwraca znaki od pozycji początkowej na końcu notatki (maksymalnie 255 znaków).Jeśli istnieje więcej niż 255 znaków z Start na końcu notatki, Metoda ta zwraca tylko 255 znaków.

Wartość zwracana

Typ: System.String

Uwagi

Notatki komórek zakresu komentarze zostały zastąpione.Aby uzyskać więcej informacji, zobacz Comment obiektu.

Aby dodać notatkę, która zawiera więcej niż 255 znaków, ta metoda raz określić pierwszych 255 znaków, a następnie użyć go ponownie dołączyć pozostałą część notatki (nie więcej niż 255 znaków naraz).

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych, zobacz Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Poniższy przykład kodu demonstruje sposób ustawiania różnych formatowania i wyświetlania właściwości NamedRange formantu niezwiązanego o nazwie NamedRange1.W szczególności, w tym przykładzie użyto NoteText metoda, aby dodać notatkę do NamedRange1 z tekstem jest test formatowanie.

W tym przykładzie jest dla dostosowania poziomu dokumentu.

' <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");
    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();
    }
}
// </Snippet35>

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel