SDS2.Plugin.UI 0.0.3-preview

Why Use This Library?

This library contains WPF themed components to match the design of SDS2.

Controls

You will find in this library that there are two types of controls. We have skinned controls, these are controls that automatically get the look of SDS2 without having to use a namespace. The other type of control are custom controls. These controls you have to prefix with a namespace to use.

Skinned

• Button
• CheckBox
• Combobox
• DatePicker
• Expander
• GroupBox
• Label
• RadioButton
• TabControl
• TabItem
• TextBlock

Custom xmlns:sc="clr-namespace:SDS2.Plugin.UI.Controls;assembly=SDS2.Plugin.UI"

• ButtonBar: Displays the four default buttons: Ok, Cancel, Reset, Help
• SDS2DistanceInput: Accents an int input and will format it to the distance format
• SDS2FileBrowser
• SDS2FolderBrowser
• SDS2Image
• SDS2Section: A stylized version of the GroupBox
• SDS2Spinner: A non-determinate progress bar
• SDS2ToggleButton
• SDS2UnitInput: A stylized textbox that will also display the unit of your choosing. The units are: Deg, Rad, Ksi, M, Mm, In, Ft

How to Use

app.xaml

<Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <ResourceDictionary Source="pack://application:,,,/SDS2.Plugin.UI;component/Themes/Dark.xaml"/>
                <ResourceDictionary Source="pack://application:,,,/SDS2.Plugin.UI;component/Themes/Light.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>

[Your]Window.xaml

<Window 
...
 xmlns:sc="clr-namespace:SDS2.Plugin.UI.Controls;assembly=SDS2.Plugin.UI"
 xmlns:sm="clr-namespace:SDS2.Plugin.UI.Models;assembly=SDS2.Plugin.UI"
 Style="{DynamicResource {x:Type Window}}"
>

<Window.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <sm:CommonDictionary Source="pack://application:,,,/SDS2.Plugin.UI;component/Resources/SDS2Icons.xaml"/>
                <sm:CommonDictionary Source="pack://application:,,,/SDS2.Plugin.UI;component/Themes/Generic.xaml"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Window.Resources>
...
</Window>

Theming

There are two themes included in this package Light and Dark. To switch between the two call the following static method:

SDS2.Plugin.UI.Themes.ThemeSwitcher.SwitchTheme(Themes.Dark);

License

This library is licensed under the MIT License.