共用方式為

NamedRange.Characters 屬性

  • 發行項

取得 Microsoft.Office.Interop.Excel.Characters 物件，表示 NamedRange 控制項文字中的字元範圍。

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

語法

'宣告
ReadOnly Property Characters As NamedRange_CharactersType
    Get

NamedRange_CharactersType Characters { get; }

屬性值

型別：Microsoft.Office.Tools.Excel.NamedRange_CharactersType
Microsoft.Office.Interop.Excel.Characters 物件，表示 NamedRange 控制項文字中的字元範圍。

備註

Characters 屬性的用意是要與下列參數一起使用。

參數

描述

Start

要傳回的第一個字元。 如果此引數為 1 或省略，則此屬性傳回的字元範圍以第一個字元為起始。

Length

要傳回的字元數。 如果省略這個引數，則此屬性傳回字串的其餘部分 (Start 字元後的所有字元)。

如果您嘗試在不指定任何參數的情況下使用 Characters，則 Characters 會得到 NamedRange_CharactersType 物件，但該物件是 Visual Studio 基礎結構的一部分，並不適合直接在程式碼中使用。

您可以使用 Microsoft.Office.Interop.Excel.Characters 物件設定文字字串內的字元格式。 Microsoft.Office.Interop.Excel.Characters 物件不是集合。

選擇性參數

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

範例

下列程式碼範例會建立 NamedRange，並將單字 Smith 填入範圍。 範例接著將單字的第一個字元變更為粗體，並設定大小為 14。

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

Private charactersRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub FormatCharacters()
    charactersRange = Me.Controls.AddNamedRange( _
        Me.Range("A1", "A1"), "charactersRange")
    Me.charactersRange.Value2 = "Smith"
    Me.charactersRange.Characters(1, 1).Font.Bold = True
    Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub

Microsoft.Office.Tools.Excel.NamedRange charactersRange;
private void FormatCharacters()
{
    charactersRange = this.Controls.AddNamedRange(
        this.Range["A1", "A1"], "charactersRange");
    this.charactersRange.Value2 = "Smith";
    this.charactersRange.Characters[1, 1].Font.Bold = true;
    this.charactersRange.Characters[1, 1].Font.Size = 14;
}

這是示範應用程式層級增益集的版本。

Private charactersRange As NamedRange

Private Sub FormatCharacters()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    charactersRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.Range("A1", "A1"), "charactersRange")
    Me.charactersRange.Value2 = "Smith"
    Me.charactersRange.Characters(1, 1).Font.Bold = True
    Me.charactersRange.Characters(1, 1).Font.Size = 14
End Sub

NamedRange charactersRange;
private void FormatCharacters()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]); ;
    charactersRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["A1", "A1"], "charactersRange");
    charactersRange.Value2 = "Smith";
    charactersRange.Characters[1, 1].Font.Bold = true;
    charactersRange.Characters[1, 1].Font.Size = 14;
}

.NET Framework 安全性

請參閱

參考

NamedRange 介面

Microsoft.Office.Tools.Excel 命名空間