syncfusion-winforms-fontlistbox（同步融合 winforms 字体列表框）

Implementing the Syncfusion WinForms FontListBox Control

The Syncfusion FontListBox (Syncfusion.Windows.Forms.Tools.FontListBox) is a ListBox-derived control that automatically populates itself with all fonts installed on the user's system. It supports multiple selection modes, type-to-match auto-complete, horizontal scrollbars, item height control, and Office-style visual themes.

When to Use This Skill

Use this skill when you need to:

• Display a list of installed system fonts — auto-populated on creation
• Allow users to select a font — apply the selected font to labels, text boxes, or other controls
• Configure selection modes — single, multi-simple, or multi-extended selection
• Enable type-to-match auto-complete — UseAutoComplete
• Apply Office visual styles — VisualStyle with FontListBoxStyle enum
• Control scrollbar visibility — HorizontalScrollbar, ScrollAlwaysVisible
• Handle font selection events — SelectedIndexChanged

Component Overview

Documentation and Navigation Guide

Getting Started

📄 Read: references/getting-started.md

• Assembly references and NuGet package setup
• Adding FontListBox via designer or programmatically
• Auto-population with system fonts
• SelectionMode — None, One, MultiSimple, MultiExtended
• Handling SelectedIndexChanged to apply font to another control

Customization and Behavior

📄 Read: references/customization-and-behavior.md

• ItemHeight — row height per font entry
• Sorted — alphabetical sorting of font names
• UseAutoComplete — type-to-match as user types
• HorizontalScrollbar + HorizontalExtent
• ScrollAlwaysVisible — force scrollbars always visible

Visual Styles

📄 Read: references/visual-styles.md

• VisualStyle property using FontListBoxStyle enum
• Available styles: Default, Metro, Office2016Colorful, Office2016White, Office2016Black, Office2016DarkGray

Quick Start

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

Common Use Cases