syncfusion-winforms-fontcombobox

FontComboBox の実装

システムフォントを自動的に一覧表示し、プレビュー機能を備えた直感的なフォント選択インターフェイスを提供する、Windows Forms 向けの専用コンボボックスコントロールです。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• フォント選択 UI：Windows Forms アプリケーションにフォント選択コントロールを実装する
• システムフォントの表示：インストール済みのすべてのフォントを視覚的なプレビュー付きで表示する
• タイポグラフィツール：テキストエディター、デザインツール、書式設定インターフェイスを構築する
• フォントの列挙：使用可能なシステムフォントをドロップダウンに自動的に一覧表示する
• リッチテキストアプリケーション：ワードプロセッサ、ドキュメントエディター、書式設定パネルを作成する
• デザインアプリケーション：フォント選択が必要な UI カスタマイズツールを構築する

コンポーネントの概要

FontComboBox は、標準の ComboBox から派生した専用コンボボックスコントロールで、次の機能を備えています。

• システムにインストールされているすべてのフォントを自動的に一覧表示します
• 各フォントを、その書体で表示します
• 素早いフォント検索のためのオートコンプリートに対応しています
• ドロップダウンを幅広くカスタマイズできます
• ビルトインのビジュアルスタイルとテーマを備えています
• 型安全なアクセスでフォント選択イベントを処理します

主な機能：

• システムフォントの自動読み込み
• ドロップダウン項目内でのフォントプレビュー
• オートコンプリートとフィルタリング
• 複数のビジュアルテーマ（Office2016、Metro、Office2007）
• RTL 対応
• シンボルフォントの描画
• カスタムイベント処理

ドキュメントとナビゲーションガイド

はじめに

📄 参照先： references/getting-started.md

参照する場面： 新しい実装を始めるとき、依存関係を設定するとき、初めて使用するとき

説明するトピック：

• アセンブリの配置と NuGet パッケージ
• FontComboBox のコントロール依存関係
• Visual Studio デザイナーから追加する方法（ツールボックスからのドラッグ＆ドロップ）
• コードから追加する方法（手動でのインスタンス化）
• 基本的な初期化と設定
• RTL（右から左）レイアウトへの対応
• サンプルの GitHub プロジェクト

---

オートコンプリート機能

📄 参照先： references/autocomplete.md

参照する場面： フォント検索を有効にするとき、入力中の検索を実装するとき、オートコンプリートの動作を設定するとき

説明するトピック：

• 有効化／無効化を切り替える UseAutoComplete プロパティ
• AutoCompleteSource のオプション（ListItems、CustomSource）
• AutoCompleteMode の設定（Suggest、Append、SuggestAppend）
• カスタムフォントリスト用の AutoCompleteCustomSource
• オートコンプリート設定のベストプラクティス
• フィルタリング動作を含むコード例

---

ドロップダウンの設定

📄 参照先： references/dropdown-configuration.md

参照する場面： ドロップダウンの外観をカスタマイズするとき、ポップアップの動作を制御するとき、項目の表示を設定するとき

説明するトピック：

• DropDownStyle のオプション（DropDown、DropDownList、Simple）
• DropDownHeight と DropDownWidth のサイズ設定
• 表示項目数を指定する MaxDropDownItems
• シンボルフォント用の ShowSymbolFontPreview
• 項目間隔を指定する ItemHeight
• アルファベット順に並べ替える Sorted プロパティ
• ドロップダウンの動作のカスタマイズ

---

選択とイベント

📄 参照先： references/selection-and-events.md

参照する場面： フォント選択の変更を処理するとき、ユーザー入力に応答するとき、選択したフォントを適用するとき

説明するトピック：

• SelectedItem と SelectedIndex によるプログラムからの選択
• SelectedIndexChanged イベントの処理
• カスタム FontSelected イベントの実装
• 選択したフォントをほかのコントロール（ラベル、テキストボックスなど）に適用する方法
• イベント駆動型のフォント更新
• 選択管理のコードパターン

---

ビジュアルスタイルとテーマ設定

📄 参照： references/visual-styles.md

参照するタイミング： テーマの適用、コントロールの外観のカスタマイズ、アプリケーションのデザインとの統一

掲載内容：

• VisualStyle プロパティ（Office2016Colorful、Office2016White、Office2016Black、Office2016DarkGray、Metro、Office2010、Office2007、Default）
• Office2007ColorScheme のオプション（Blue、Silver、Black）
• Office2007ColorTheme.Managed を使用したカスタムカラーテーマ
• カスタムカラーの適用に使用する ApplyManagedColors
• テーマのスクリーンショットとビジュアル例

---

クイックスタート

FontComboBox の基本設定

using Syncfusion.Windows.Forms.Tools;

// Create and configure FontComboBox
FontComboBox fontComboBox = new FontComboBox();
fontComboBox.Size = new Size(200, 25);
fontComboBox.Location = new Point(20, 20);

// Enable AutoComplete for font search
fontComboBox.UseAutoComplete = true;

// Set default selected font
fontComboBox.Text = "Arial";

// Add to form
this.Controls.Add(fontComboBox);

フォント選択の処理

// Subscribe to selection changed event
fontComboBox.SelectedIndexChanged += FontComboBox_SelectedIndexChanged;

private void FontComboBox_SelectedIndexChanged(object sender, EventArgs e)
{
    if (fontComboBox.Text != null)
    {
        // Apply selected font to a label
        label1.Font = new Font(fontComboBox.Text.ToString(), 12, FontStyle.Regular);
    }
}

よく使われるパターン

パターン 1：プレビュー付きフォント選択

// Configure FontComboBox with preview
FontComboBox fontComboBox = new FontComboBox
{
    UseAutoComplete = true,
    DropDownStyle = ComboBoxStyle.DropDownList,
    ShowSymbolFontPreview = true,
    DropDownHeight = 200,
    Sorted = true
};

// Handle selection to update preview label
fontComboBox.SelectedIndexChanged += (s, e) =>
{
    if (fontComboBox.Text != null)
    {
        previewLabel.Font = new Font(fontComboBox.Text.ToString(), 14);
        previewLabel.Text = "The quick brown fox jumps over the lazy dog";
    }
};

パターン 2：テーマ設定可能なフォントセレクター

// Apply Office2016 theme
FontComboBox fontComboBox = new FontComboBox
{
    VisualStyle = ThemedComboBoxStyles.Office2016Colorful,
    UseAutoComplete = true,
    DropDownStyle = ComboBoxStyle.DropDown
};

// Set initial font
fontComboBox.Text = "Segoe UI";

パターン 3：オートコンプリート付きカスタムフォントリスト

// Create FontComboBox with custom font list
FontComboBox fontComboBox = new FontComboBox();

// Configure custom AutoComplete source
fontComboBox.AutoCompleteCustomSource.AddRange(new string[] 
{
    "Arial", "Calibri", "Cambria", "Georgia", "Times New Roman", "Verdana"
});
fontComboBox.AutoCompleteMode = AutoCompleteMode.SuggestAppend;
fontComboBox.AutoCompleteSource = AutoCompleteSource.CustomSource;

主なプロパティ

選択プロパティ

• SelectedItem：現在選択されているフォント名（string）を取得または設定します
• SelectedIndex：選択されているフォントのインデックス（int）を取得または設定します

オートコンプリートプロパティ

• UseAutoComplete：オートコンプリート機能を有効または無効にします（bool）
• AutoCompleteMode：補完動作を設定します（Suggest、Append、SuggestAppend）
• AutoCompleteSource：補完元を指定します（ListItems、CustomSource）
• AutoCompleteCustomSource：オートコンプリート用のカスタム文字列コレクション

ドロップダウンプロパティ

• DropDownStyle：編集／選択の動作を制御します（DropDown、DropDownList、Simple）
• DropDownHeight：ドロップダウンの高さをピクセル単位で指定します（int）
• DropDownWidth：ドロップダウンの幅をピクセル単位で指定します（int）
• MaxDropDownItems：ドロップダウンに表示する項目の最大数（int）
• ShowSymbolFontPreview：シンボルフォントをその書体で描画します（bool）

項目プロパティ

• ItemHeight：各ドロップダウン項目の高さをピクセル単位で指定します（int）
• Sorted：フォントをアルファベット順に並べ替えます（bool）

スタイル設定プロパティ

• VisualStyle：コントロールのテーマを設定します（Office2016Colorful、Metro、Office2007 など）
• Office2007ColorScheme：Office2007 スタイルの配色を設定します（Blue、Silver、Black）
• Office2007ColorTheme：カスタムテーマのモードを設定します（カスタムカラーには Managed を指定）

レイアウトプロパティ

• RightToLeft：右から左へのレイアウトを有効にします（RightToLeft.Yes/No）

よくある用途

リッチテキストエディターのフォントセレクター

ドキュメントエディター、ワープロ、メールクライアントのテキスト書式設定ツールバーにフォント選択機能を作成します。

デザインツールのタイポグラフィパネル

グラフィックデザインアプリケーション、プレゼンテーションソフトウェア、UI ビルダーにフォント選択機能を実装します。

アプリケーション設定のフォント構成

テキスト表示をカスタマイズできるアプリケーション用に、フォント設定ダイアログを作成します。

カスタムコントロールのプロパティエディター

ユーザーがカスタムコントロールのフォントを選択できるプロパティグリッドや設定パネルを作成します。

フォント比較ツール

ライブプレビューを使ってフォントを並べて比較するユーティリティを開発します。

注意事項

• UseAutoComplete = true を設定すると、FontComboBox はシステムにインストールされているすべてのフォントを自動的に読み込みます。フォントを手動で列挙する必要はありません。
• ShowSymbolFontPreview を使用すると、シンボルフォントを実際のグリフで表示できます
• 手動でのテキスト入力を防ぎ、フォントの選択のみを許可するには、DropDownList スタイルを使用します
• SelectedIndexChanged は、選択がプログラムまたはユーザーによって変更されるたびに発生します
• 標準の ComboBox を継承しているため、すべての基本プロパティとイベントを使用できます