Shos.Windows 1.0.0

Shos.Windows

English | 日本語

A small WPF library for .NET 8.0 and .NET 10.0.

• FontComboBox: a combo box to select one of the system font families
• EnumToBooleanConverter: a converter to bind multiple radio buttons to a single enum property

Installation

Install from NuGet: NuGet Gallery | Shos.Windows

dotnet add package Shos.Windows

Requirements

• .NET 8.0 (net8.0-windows) or .NET 10.0 (net10.0-windows)
• WPF (<UseWPF>true</UseWPF>)

Class Diagram

The public types and members of Shos.Windows (+: public, #: protected, underlined: static). ComboBox (System.Windows.Controls) and IValueConverter (System.Windows.Data) are WPF types.

classDiagram
    direction LR

    class ComboBox
    class IValueConverter {
        <<interface>>
    }

    namespace Shos.Windows.Controls {
        class FontComboBox {
            +DependencyProperty SelectedFontFamilyProperty$
            +DependencyProperty SelectedFontFamilyNameProperty$
            +DependencyProperty SelectedLocalFontFamilyNameProperty$
            +FontFamily? SelectedFontFamily
            +string SelectedFontFamilyName
            +string SelectedLocalFontFamilyName
            +FontComboBox()
            #OnSelectionChanged(SelectionChangedEventArgs e) void
        }
    }

    namespace Shos.Windows.Data {
        class EnumToBooleanConverter {
            +Convert(object? value, Type targetType, object? parameter, CultureInfo culture) object
            +ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture) object
        }
    }

    ComboBox <|-- FontComboBox
    IValueConverter <|.. EnumToBooleanConverter

Controls

FontComboBox

Namespace: Shos.Windows.Controls

Derives from System.Windows.Controls.ComboBox.

A combo box to select one of the system font families.

• Each item is drawn with its own font. Symbol fonts (e.g. Marlett, Wingdings) are drawn with the default font so that their names stay readable.
• Items are shown by their localized names (for the current culture) and sorted by them. Typing a name selects the matching item.
• Items are virtualized, so the drop-down opens quickly even when many fonts are installed.
• The font list is built once and shared by all instances.

Properties

The following properties are kept synchronized with each other and with SelectedItem, and bind two-way by default. Names are compared case-insensitively. When a value that matches no system font is set, the selection is cleared (SelectedFontFamily becomes null, and the name properties become "").

Example

<Window xmlns:shoswindowscontrols="clr-namespace:Shos.Windows.Controls;assembly=Shos.Windows" ...>
    <StackPanel>
        <shoswindowscontrols:FontComboBox SelectedFontFamilyName="{Binding SelectedFontFamilyName}" />
        <TextBox FontFamily="{Binding SelectedFontFamilyName}" />
    </StackPanel>
</Window>

You can also bind the FontFamily object directly:

<shoswindowscontrols:FontComboBox x:Name="fontComboBox" />
<TextBox FontFamily="{Binding SelectedFontFamily, ElementName=fontComboBox}" />

Converters

EnumToBooleanConverter

Namespace: Shos.Windows.Data

Implements System.Windows.Data.IValueConverter.

Used to bind multiple radio buttons to a single enum property.

• Convert: returns true when the enum value equals the converter parameter, otherwise false.
• ConvertBack: returns the converter parameter when the value is true. Otherwise (e.g. when a radio button is unchecked) the source is not updated (Binding.DoNothing).

The converter parameter can be either:

• the enum value itself (e.g. ConverterParameter={x:Static local:FontSizeKind.Small}), or
• the name of an enum member (e.g. ConverterParameter=Small).

Nullable enum properties (e.g. FontSizeKind?) are also supported. When the value is not an enum or the parameter does not match the enum type, Convert returns DependencyProperty.UnsetValue.

Example

public enum FontSizeKind { Small, Medium, Large }

<Window xmlns:shoswindowsdata="clr-namespace:Shos.Windows.Data;assembly=Shos.Windows"
        xmlns:local="clr-namespace:YourApp" ...>
    <Window.Resources>
        <shoswindowsdata:EnumToBooleanConverter x:Key="enumToBooleanConverter" />
    </Window.Resources>
    <StackPanel>
        <RadioButton Content="Small"  IsChecked="{Binding FontSizeKind, Converter={StaticResource enumToBooleanConverter}, ConverterParameter={x:Static local:FontSizeKind.Small}}" />
        <RadioButton Content="Medium" IsChecked="{Binding FontSizeKind, Converter={StaticResource enumToBooleanConverter}, ConverterParameter={x:Static local:FontSizeKind.Medium}}" />
        <RadioButton Content="Large"  IsChecked="{Binding FontSizeKind, Converter={StaticResource enumToBooleanConverter}, ConverterParameter={x:Static local:FontSizeKind.Large}}" />
    </StackPanel>
</Window>

Projects

Building from Source

Requires Windows and the .NET 10.0 SDK (plus the .NET 8.0 runtime to run the tests for net8.0-windows).

git clone https://github.com/Fujiwo/Shos.Windows.git
cd Shos.Windows
dotnet build Shos.Windows.sln --configuration Release
dotnet test Shos.Windows.sln --configuration Release --no-build

The NuGet package (containing both net8.0-windows and net10.0-windows assemblies) is generated in Shos.Windows/bin/Release/.

Author Info

Fujio Kojima: a software developer in Japan

• Microsoft MVP for Development Tools - Visual C# (Jul. 2005 - Dec. 2014)
• Microsoft MVP for .NET (Jan. 2015 - Oct. 2015)
• Microsoft MVP for Visual Studio and Development Technologies (Nov. 2015 - Jun. 2018)
• Microsoft MVP for Developer Technologies (Nov. 2018 - Jun. 2027)
• MVP Profile
• Blog (Japanese)
• Web Site (Japanese)

License

This library is under the MIT License.