NamedRange.NoteText(Object, Object, Object) 方法

  • 參考

定義

命名空間:
Microsoft.Office.Tools.Excel
組件:
Microsoft.Office.Tools.Excel.dll

取得或設定與 NamedRange 控制項左上角儲存格關聯的儲存格備註。

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

參數

Text
Object

加入到備註的文字 (最多 255 個字元)。 文字會從位置 Start開始插入，取代 Length 現有附註的字元。 如果省略這個自變數，這個方法會針對字元傳回從位置 StartLength 開始的記事目前文字。

Start
Object

設定或傳回文字的起點位置。 如果省略這個引數，這個方法會從第一個字元開始。 若要將文字附加到備註上，請指定一個大於現有備註中字元數目的數字。

Length
Object

要設定或傳回的字元數。 如果省略這個引數，Microsoft Office Excel 會從備註的起點開始到結尾處，設定或傳回字元 (最多 255 個字元)。 如果自附注結尾超過 255 個字元 Start ，這個方法只會傳回 255 個字元。

傳回

String

範例

下列程式代碼範例示範如何設定名為 NamedRange1的NamedRange控件的各種格式設定和顯示特性。 特別是，這個範例會使用 方法， NoteText 將附註新增至 NamedRange1 ，並加上文字 This is a Formatting test。

此範例適用於檔層級自定義。

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

備註

單元格附注已由範圍批注取代。 如需詳細資訊，請參閱 Comment 物件。

若要新增包含超過 255 個字元的附注，請使用此方法一次來指定前 255 個字元，然後再次使用它來附加附注的其餘部分 (一次不超過 255 個字元) 。

選擇性參數

如需選擇性參數的資訊，請參閱 Office 方案中的選擇性參數。

適用於