Jon.Wpf.CustomControls 1.5.0

Jon.WPF.CustomControls

Welcome to Jon.WPF.CustomControls, a .NET 7.0 WPF C# custom control library. This library aims to provide an assortment of WPF controls to enhance your application's user interface.

Table of Contents

• About
• Getting Started
• Usage
• Controls
• Contributing
• License
• Contact

About

Jon.WPF.CustomControls is a collection of custom, reusable WPF controls. It is built with .NET 7.0 and intended to provide developers with controls that are commonly used but not included in the standard WPF toolkit.

Getting Started

1. Clone the repo: git clone https://github.com/yourusername/Jon.WPF.CustomControls.git
2. Open the solution in Visual Studio 2023 or later.
3. Build the solution to ensure everything is set up correctly.
4. Start using the controls in your projects!

Usage

Reference the Jon.WPF.CustomControls.dll in your WPF project. You can now use the controls by adding the appropriate namespace to your XAML files.

xmlns:custom="clr-namespace:Jon.WPF.CustomControls;assembly=Jon.WPF.CustomControls"

You can then use the controls like any other WPF control:

<custom:NumericUpDown x:Name="MyNumericUpDown" />

Controls

This library currently includes the following controls:

• NumericUpDown: A NumericUpDown control that allows users to increase or decrease a numeric value with up and down buttons. NEW
• WizardControl: A control that presents a series of WizardPages to assist the user in performing a task or series of tasks. NEW
• WizardPage: A page within a WizardControl that contains content to guide the user through a specific part of the task. NEW
• RgbColorPicker: A color picker control that allows users to select a color using RGB (Red, Green, Blue) components.
• ColorPaletteControl: A color palette control that provides a grid of colors for the user to choose from.
• RatingControl: A control for rating items on a scale.
• TimePicker: A time selection control.
• ToggleSwitch: A binary selection control, similar to a checkbox, but with a sleek design.
• WatermarkTextbox: A text box with a placeholder text feature, also known as watermark.
• PropertyGrid: A control for displaying and editing the properties of an object.
• Coming Soon:
  • CollectionControlDialog - View List or Observable Collection in a dialog window. Each can open up a separate property grid dialog.
  • Range Slider - Two bar slider where a range can be selected.

Please refer to each control's documentation for more details.

Remember to create the corresponding `WizardControl

Converters

Converters are used in WPF to transform data from one type to another. They are often used in data binding scenarios, where the source data may not be in the correct format for the target property. Here are the converters included in this library:

• BoolToIntConverter: Converts a boolean value to an integer. Typically used for scenarios where a boolean value needs to be represented as an integer.
• BoolToTranslateConverter: Converts a boolean value to a translation transform. Useful for moving UI elements based on a boolean condition.
• BoolToVisibilityConverter: Converts a boolean value to a Visibility enumeration. Commonly used to show or hide UI elements based on a boolean condition.
• BoolToCollapsedConverter: Similar to BoolToVisibilityConverter, but collapses the UI element when the boolean is false.
• ToggleSwitchForegroundConverter: Used specifically for the ToggleSwitch control to determine the foreground color based on the switch's state.
• ToggleSwitchBackgroundConverter: Used specifically for the ToggleSwitch control to determine the background color based on the switch's state.
• ToggleSwitchHandleColorConverter: Used specifically for the ToggleSwitch control to determine the handle color based on the switch's state.
• ColorToBrushConverter: Converts a Color to a Brush. Useful for binding scenarios where a Brush is required but the source is a Color.
• BrushToColorConverter: Converts a Brush to a Color. Useful for binding scenarios where a Color is required but the source is a Brush.
• HalfSizeConverter: Takes a size and returns half of it. Useful for positioning or sizing elements relative to others.
• DateTimeToAmPmConverter: Converts a DateTime to a string representing either "AM" or "PM".
• SelectorValuesToDateTimeConverter: Converts selector values to a DateTime. Used in the TimePicker control.
• ColorEqualityConverter: Checks if two colors are equal. Useful for color comparison scenarios.
• ColorToNameConverter: Converts a Color to its name as a string, if it has one.
• PropertyNameConverter: Converts a property name to a more user-friendly format.

Please note that the exact behavior of each converter may depend on its implementation and usage in the controls.

Contributing

We welcome contributions from everyone. Before you start, please see the CONTRIBUTING.md for details on how to contribute to this project.

License

This project is licensed under the MIT License. For more information, see the LICENSE file.

Contact

If you have any questions, feel free to reach out to us. You can contact us via email or create an issue on our GitHub page. We'll do our best to respond as quickly as possible.