XmlMappedRange.NoteText 方法

  • 發行項

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

命名空間：  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 方案中的選擇性參數。

範例

下列程式碼範例使用 NoteText 方法，將備註加入 XmlMappedRange，然後提示使用者藉由 ClearNotes 方法移除備註。 這個程式碼範例假設目前工作表包含名為 CustomerLastNameCell 的 XmlMappedRange。

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

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();
    }
}

.NET Framework 安全性

請參閱

參考

XmlMappedRange 介面

Microsoft.Office.Tools.Excel 命名空間