Share via

NamedRange.NoteText 方法

  • 發行項

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

命名空間：  Microsoft.Office.Tools.Excel
組件：  Microsoft.Office.Tools.Excel (在 Microsoft.Office.Tools.Excel.dll 中)

語法

'宣告
Function NoteText ( _
    Text As Object, _
    Start As Object, _
    Length As Object _
) As String

string NoteText(
    Object Text,
    Object Start,
    Object Length
)

參數

  • Text
    型別：System.Object
    加入到備註的文字 (最多 255 個字元)。插入文字，起點為位置 Start，取代現有備註的 Length 字元。如果省略這個引數，此方法會傳回目前備註中，以位置 Start 為起點，長 Length 個字元的文字。
  • Start
    型別：System.Object
    設定或傳回文字的起點位置。如果省略這個引數，這個方法會從第一個字元開始。若要將文字附加到備註上，請指定一個大於現有備註中字元數目的數字。
  • Length
    型別：System.Object
    要設定或傳回的字元數。如果省略這個引數，Microsoft Office Excel 會從備註的起點開始到結尾處，設定或傳回字元 (最多 255 個字元)。如果從備註的 Start 到結尾處，超過 255 個字元，則這個方法只會傳回 255 個字元。

傳回值

型別：System.String

備註

儲存格備註已由範圍註解取代。 如需詳細資訊，請參閱 Comment 物件。

若加入的備註超過 255 個字元，請使用這個方法一次以指定前 255 個字元，然後再使用此方法，附加剩下的備註 (一次不超過 255 個字元)。

選擇性參數

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

範例

下列程式碼範例會示範如何設定名稱為 NamedRange1 之 NamedRange 控制項的各種格式化和顯示特性。 請特別注意，此範例會使用 NoteText 方法將備註加入至 NamedRange1，備註的文字為 This is a Formatting test。

這是示範文件層級自訂的範例。

' <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>

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間