このコレクションは、ユーザーがGcFontPickerコントロールのお気に入りフォントおよび最近使用したフォントを独自にカスタマイズできるようにするため、GcFontPicker.PreferredFontsプロパティとGcFontPicker.RecentlyUsedFontsプロパティで使用されます。

このコレクションにFontInfoオブジェクトを追加する方法はいくつかあります。Addメソッドは、単一のFontInfoオブジェクトをコレクションに追加します。複数のFontInfoオブジェクトをコレクションに追加するには、FontInfoオブジェクトの配列を作成し、その配列をAddRange(FontInfo[])メソッドに渡します。コレクション内の特定の位置にFontInfoオブジェクトを挿入する場合は、Insertメソッドを使用します。FontInfoオブジェクトを削除するには、Removeメソッドを使用するか、削除するオブジェクトのコレクション内での位置がわかっている場合はSystem.Collections.CollectionBase.RemoveAt(System.Int32)メソッドを使用します。コレクションからFontInfoオブジェクトをすべて削除する場合は、Removeメソッドを使用してFontInfoオブジェクトを一度に1つずつ削除する代わりに、System.Collections.CollectionBase.Clearメソッドを使用できます。

FontInfoオブジェクトを追加または削除するメソッドとプロパティに加えて、FontInfoCollectionにはコレクション内でFontInfoオブジェクトを検索するメソッドも用意されています。Containsメソッドを使用すると、特定のFontInfoオブジェクトがコレクションのメンバであるかどうかを確認できます。オブジェクトがコレクション内にあることがわかったら、IndexOfメソッドを使用して、そのオブジェクトのコレクション内での位置を確認できます。さらに、FindStringメソッドを使用して、指定した文字列と名前が部分的に一致するFontInfoオブジェクトを検索できます。部分一致ではなく完全に一致するFontInfoオブジェクトを検索する場合は、FindStringExactメソッドを使用します。

また、このコレクション内の特定の検索文字列を含むFontInfoオブジェクトを検索するには、FindStringメソッドまたはFindStringExactメソッドを使用します。

次のサンプルコードは、FontInfoCollection型である、GcFontPickerコントロールのGcFontPicker.PreferredFontsを使用する方法を示します。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

private void CreateGcFontPickerWithPreferredFonts()
{
    // 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);

    // Initialize PreferredFonts.
    gcFontPicker.ShowPreferredFonts = true;
    gcFontPicker.PreferredFonts.AddRange(new FontInfo[] 
    {
        new FontInfo("MingLiU", "Represents MingLiU Font"),
        new FontInfo("MS UI Gothic","Represents MS UI Gothic Font"),
        new FontInfo("Nina","Represents Nina Font"),
        new FontInfo("Vrinda","Represents Vrinda Font"),
    });
    gcFontPicker.ItemGroupStyle.PreferredFontsText = "My Preferred Fonts";

    // Set the SelectedFont to the first item of PreferredFonts.
    gcFontPicker.SelectedFontInfo = gcFontPicker.PreferredFonts[0];

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

Private Sub CreateGcFontPickerWithPreferredFonts()
    ' 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)

    ' Initialize PreferredFonts.
    gcFontPicker.ShowPreferredFonts = True
    gcFontPicker.PreferredFonts.AddRange(New FontInfo() {New FontInfo("MingLiU", "Represents MingLiU Font"), New FontInfo("MS UI Gothic", "Represents MS UI Gothic Font"), New FontInfo("Nina", "Represents Nina Font"), New FontInfo("Vrinda", "Represents Vrinda Font")})
    gcFontPicker.ItemGroupStyle.PreferredFontsText = "My Preferred Fonts"

    ' Set the SelectedFontInfo to the first item of PreferredFonts.
    gcFontPicker.SelectedFontInfo = gcFontPicker.PreferredFonts(0)

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

System.Object
   System.Collections.CollectionBase
      GrapeCity.Win.Pickers.FontInfoCollection

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

FontInfoCollection メンバ
GrapeCity.Win.Pickers 名前空間
GcFontPicker クラス
PreferredFonts プロパティ
RecentlyUsedFonts プロパティ
GcFontPicker クラス
PreferredFonts プロパティ
RecentlyUsedFonts プロパティ