XmlMappedRange.NoteText(Object, Object, Object) Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.dll

Denetimle ilişkili hücre notunu XmlMappedRange alır veya ayarlar.

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

Parametreler

Text

Object

Nota eklenecek metin (en fazla 255 karakter). Metin, konumundan Startbaşlayarak, var olan notun karakterleri değiştirerek Length eklenir. Bu bağımsız değişken atlanırsa, bu yöntem karakterler için Length konumundan Startbaşlayarak notun geçerli metnini döndürür.

Start

Object

Ayarlanan veya döndürülen metnin başlangıç konumu. Bu bağımsız değişken atlanırsa, bu yöntem ilk karakterden başlar. Nota metin eklemek için, var olan nottaki karakter sayısından daha büyük bir sayı belirtin.

Length

Object

Ayarlanacak veya döndürülecek karakter sayısı. Bu bağımsız değişken atlanırsa, Microsoft Office Excel başlangıç konumundan notun sonuna kadar (en fazla 255 karakter) karakterleri ayarlar veya döndürür. Notun sonuna kadar 255'ten Start fazla karakter varsa, bu yöntem yalnızca 255 karakter döndürür.

Döndürülenler

String

Örnekler

Aşağıdaki kod örneği yöntemiyle NoteText bir XmlMappedRangeöğesine not ekler ve ardından kullanıcıdan yöntemini kullanarak notu kaldırmasını ClearNotes ister. Bu kod örneği, geçerli çalışma sayfasının adlı CustomerLastNameCellbir XmlMappedRange içerdiğini varsayar.

private void SetNote()
{
    this.CustomerLastNameCell.NoteText("This cell contains customer " +
        "last names.");

    if (MessageBox.Show("Remove the note?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearNotes();
    }
}

Private Sub SetNote()
    Me.CustomerLastNameCell.NoteText("This cell contains customer " & _
        "last names.")

    If MessageBox.Show("Remove the note?", "Test", MessageBoxButtons.YesNo) = _
        DialogResult.Yes Then
        Me.CustomerLastNameCell.ClearNotes()
    End If
End Sub

Açıklamalar

Hücre notlarının yerini aralık açıklamaları aldı. Daha fazla bilgi için nesneye Comment bakın.

255'ten fazla karakter içeren bir not eklemek için, bu yöntemi bir kez kullanarak ilk 255 karakteri belirtin ve sonra notun geri kalanını eklemek için yeniden kullanın (aynı anda en fazla 255 karakter).

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümlerinde İsteğe Bağlı Parametreler.