syncfusion-winforms-fontlistbox

Syncfusion WinForms FontListBox コントロールの実装

Syncfusion の FontListBox（Syncfusion.Windows.Forms.Tools.FontListBox）は、ユーザーのシステムにインストールされているすべてのフォントを自動的に表示する、ListBox 派生コントロールです。複数の選択モード、入力文字列に一致する項目を検索するオートコンプリート、水平スクロールバー、項目の高さの調整、Office スタイルのビジュアルテーマに対応しています。

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

次のような場合に、このスキルを使用します。

• インストール済みのシステムフォントを一覧表示する — 作成時に自動的に一覧が表示されます
• ユーザーがフォントを選択できるようにする — 選択したフォントをラベル、テキストボックス、またはその他のコントロールに適用します
• 選択モードを設定する — 単一選択、複数選択（単純）、または複数選択（拡張）
• 入力文字列に一致する項目を検索するオートコンプリートを有効にする — UseAutoComplete
• Office のビジュアルスタイルを適用する — FontListBoxStyle 列挙型を使用した VisualStyle
• スクロールバーの表示を制御する — HorizontalScrollbar、ScrollAlwaysVisible
• フォント選択イベントを処理する — SelectedIndexChanged

コンポーネントの概要

プロパティ	型	説明
SelectionMode	SelectionMode	One、MultiSimple、または MultiExtended
UseAutoComplete	bool	入力に応じてリスト内の項目を検索
Sorted	bool	フォント名をアルファベット順に並べ替えます
ItemHeight	int	各リスト項目の高さ（ピクセル単位）
HorizontalScrollbar	bool	項目が収まらない場合に水平スクロールバーを表示します
HorizontalExtent	int	水平スクロールバーが有効な場合のスクロール可能領域の幅（ピクセル単位）
ScrollAlwaysVisible	bool	項目数にかかわらずスクロールバーを表示したままにします
VisualStyle	FontListBoxStyle	Office／Metro のビジュアルテーマ

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

はじめに

📄 参照: references/getting-started.md

• アセンブリ参照と NuGet パッケージの設定
• デザイナーまたはプログラムから FontListBox を追加する方法
• システムフォントの自動表示
• SelectionMode — None、One、MultiSimple、MultiExtended
• SelectedIndexChanged を処理して、別のコントロールにフォントを適用する方法

カスタマイズと動作

📄 参照: references/customization-and-behavior.md

• ItemHeight — フォント項目ごとの行の高さ
• Sorted — フォント名をアルファベット順に並べ替え
• UseAutoComplete — ユーザーの入力に応じて一致する項目を検索
• HorizontalScrollbar と HorizontalExtent
• ScrollAlwaysVisible — スクロールバーを常に表示する設定

ビジュアルスタイル

📄 参照: references/visual-styles.md

• FontListBoxStyle 列挙型を使用する VisualStyle プロパティ
• 使用可能なスタイル：Default、Metro、Office2016Colorful、Office2016White、Office2016Black、Office2016DarkGray

クイックスタート

C#:

using Syncfusion.Windows.Forms.Tools;

FontListBox fontListBox1 = new FontListBox();
fontListBox1.Size = new System.Drawing.Size(160, 94);
fontListBox1.UseAutoComplete = true;
fontListBox1.SelectionMode = System.Windows.Forms.SelectionMode.One;
fontListBox1.SelectedIndexChanged += FontListBox1_SelectedIndexChanged;
this.Controls.Add(fontListBox1);

private void FontListBox1_SelectedIndexChanged(object sender, EventArgs e)
{
    label1.Font = new System.Drawing.Font(
        fontListBox1.SelectedItem.ToString(), 11, System.Drawing.FontStyle.Regular);
}

VB.NET:

Imports Syncfusion.Windows.Forms.Tools

Dim fontListBox1 As New FontListBox()
fontListBox1.Size = New System.Drawing.Size(160, 94)
fontListBox1.UseAutoComplete = True
fontListBox1.SelectionMode = System.Windows.Forms.SelectionMode.One
AddHandler fontListBox1.SelectedIndexChanged, AddressOf FontListBox1_SelectedIndexChanged
Me.Controls.Add(fontListBox1)

Private Sub FontListBox1_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
    label1.Font = New System.Drawing.Font(
        fontListBox1.SelectedItem.ToString(), 11, System.Drawing.FontStyle.Regular)
End Sub

一般的なユースケース

シナリオ	設定するプロパティ
テキストエディター用のフォント選択	SelectionMode = One を設定し、SelectedIndexChanged を処理
複数のフォントを選択	SelectionMode = MultiExtended
キーボードで素早く移動	UseAutoComplete = true
スクロールバーを常に表示	ScrollAlwaysVisible = true
アルファベット順に並べ替えたリスト	Sorted = true
Office スタイルの外観	VisualStyle = FontListBoxStyle.Office2016Colorful