共用方式為

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

  • 參考

定義

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

取得或設定與 XmlMappedRange 控制項相關的儲存格備註。

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

範例

下列程式代碼範例會 NoteText 使用 方法將附註新增至 XmlMappedRange，然後使用 方法提示使用者移除附注 ClearNotes 。 這個程式代碼範例假設目前的工作表包含 XmlMappedRange 名為 CustomerLastNameCell的 。

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

備註

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

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

選擇性參數

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

適用於