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

Tanım

Ad Alanı:

Microsoft.Office.Tools.Excel

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Excel.dll

Denetimin sol üst köşesindeki hücreyle ilişkili hücre notunu NamedRange 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 notun başlangıç konumundan 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, adlı NamedRange1denetimin çeşitli biçimlendirme ve görüntüleme özelliklerini ayarlamayı NamedRange gösterir. Özellikle, bu örnekte metniyle This is a Formatting testnot eklemek için NamedRange1 yöntemini kullanırNoteText.

Bu örnek, belge düzeyinde özelleştirme içindir

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

Açıklamalar

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

255'ten fazla karakter içeren bir not eklemek için, ilk 255 karakteri belirtmek için bu yöntemi bir kez kullanın 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ümleri'nde İsteğe Bağlı Parametreler.