NamedRange.Characters プロパティ (2007 System)

更新 : 2008 年 7 月

NamedRange コントロールのテキスト内での文字範囲を表す Microsoft.Office.Interop.Excel.Characters オブジェクトを取得します。

名前空間 :  Microsoft.Office.Tools.Excel
アセンブリ :  Microsoft.Office.Tools.Excel.v9.0 (Microsoft.Office.Tools.Excel.v9.0.dll 内)

構文

'宣言
<BrowsableAttribute(False)> _
Public ReadOnly Property Characters As NamedRange..::._CharactersType
'使用
Dim instance As NamedRange
Dim value As NamedRange..::._CharactersType

value = instance.Characters
[BrowsableAttribute(false)]
public NamedRange..::._CharactersType Characters { get; }

プロパティ値

型 : Microsoft.Office.Tools.Excel.NamedRange._CharactersType

NamedRange コントロールのテキスト内での文字範囲を表す Microsoft.Office.Interop.Excel.Characters オブジェクトを返します。

解説

Characters プロパティは、次のパラメータと共に使用します。

パラメータ

説明

Start

返す最初の文字です。この引数に 1 を指定するか、または省略した場合、このプロパティは、最初の文字から始まる文字範囲を返します。

Length

返す文字数です。この引数を省略した場合、このプロパティは、残りの文字列 (Start 文字以降のすべての文字) を返します。

パラメータを指定せずに Characters を使用すると、Characters は NamedRange._CharactersType オブジェクトを取得します。このオブジェクトは、Visual Studio Tools for Office インフラストラクチャの一部であり、コードから直接使用するためのオブジェクトではありません。

文字列内の文字を書式設定するには、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 vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    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 = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    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;
}

アクセス許可

  • 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

参照

NamedRange クラス

NamedRange メンバ

Microsoft.Office.Tools.Excel 名前空間

履歴の変更

日付

履歴

理由

2008 年 7 月

アプリケーション レベルのアドインのコード例のバージョンを追加

SP1 機能変更