Udostępnij za pośrednictwem


Metoda NamedRange.NoteText —

Pobiera lub ustawia Uwaga komórki skojarzonych z komórki w lewym górnym rogu 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ć na końcu notatki (maksymalnie 255 znaków).Dodaje się tekst, 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, dla Length znaków.
  • Start
    Typ: System.Object
    Pozycja początkowa dla tekstu, który ma lub zwracane.Jeśli ten argument zostanie pominięty, ta metoda rozpoczyna się od pierwszego znaku.Aby dołączyć tekst do notatki, należy określić numer większy niż liczba znaków w istniejącej notatki.
  • Length
    Typ: System.Object
    Liczba znaków został ustawiony lub zwrócony.Jeśli ten argument zostanie pominięty, program Microsoft Office Excel ustawia lub zwraca znaki z 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 zostały zastąpione przez zakres komentarze.Aby uzyskać więcej informacji, zobacz Comment obiektu.

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

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

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

Ten przykład dotyczy dostosowywania poziomie 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