CharSets プロパティ (FontInfoFilter)

GcFontPickerコントロールの選択可能なフォントをフィルタリングするために使用される文字セットのコレクションを取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property CharSets As CharSetCollection

public CharSetCollection CharSets {get; set;}

プロパティ値

GcFontPickerコントロールのフォントのフィルタリングに使用されるCharSetCollection。このコレクションのデフォルト値には、FontCharSet列挙体のすべての値が含まれます。

解説

このFontInfoFilterに関連付けられたGcFontPickerに表示されるフォントを文字セットでフィルタリングする場合は、このプロパティを、サポートするFontCharSetを含むCharSetCollectionインスタンスに割り当てます。そうすると、このFontInfoFilterに関連付けられたGcFontPickerのAllFontsコレクションには、指定した文字セットをサポートするフォントのみが格納され、ユーザーが選択するためのドロップダウンリストにはそれらのフォントの名前が表示されます。

使用例

次のサンプルコードは、GcFontPicker.ItemFilterプロパティ上でFontTypesプロパティとCharSetsプロパティを設定して、GcFontPickerのドロップダウンリストのすべてのフォントグループに表示されるフォント名をフィルタリングします。この例では、OpenTypeフォントのうち日本語文字セットと簡体字中国語文字セットをサポートするフォントのみをすべてのフォントグループに表示しています。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

private void CreateGcFontPickerWithItemFilter()
{
    // Create an instance of GcFontPicker control.
    GcFontPicker gcFontPicker = new GcFontPicker();

    // Initialize the Name and Location of the gcFontPicker.
    gcFontPicker.Name = "gcFontPicker";
    gcFontPicker.Location = new Point(10, 50);

    // Set ItemFilter.
    gcFontPicker.ItemFilter.FontTypes = FilterFontTypes.OpenTypeFont;
    gcFontPicker.ItemFilter.CharSets = new CharSetCollection(new FontCharSet[] { FontCharSet.Japanese , FontCharSet.Chinese_Simplified});

    // adds gcFontPicker to the form.
    this.Controls.Add(gcFontPicker);
}

Private Sub CreateGcFontPickerWithItemFilter()
    ' Create an instance of GcFontPicker control.
    Dim gcFontPicker As New GcFontPicker()

    ' Initialize the Name and Location of the gcFontPicker.
    gcFontPicker.Name = "gcFontPicker"
    gcFontPicker.Location = New Point(10, 50)

    ' Set ItemFilter.
    gcFontPicker.ItemFilter.FontTypes = FilterFontTypes.OpenTypeFont
    gcFontPicker.ItemFilter.CharSets = New CharSetCollection(New FontCharSet() {FontCharSet.Japanese, FontCharSet.Chinese_Simplified})

    ' adds gcFontPicker to the form.
    Me.Controls.Add(gcFontPicker)
End Sub

プラットフォーム

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

FontInfoFilter クラス
 FontInfoFilter メンバ
 CharSetCollection クラス
 CharSetCollection クラス