HandyControl Documentation

HandyControl is a collection of UI controls and features for .NET applications. It is based on the original HandyControl project but extends it with additional capabilities, including:

• Support for Persian Calendar and PersianDate.
• Additional controls and expanded styles.

It requires .NET 4.0 or higher.

The NumericUpDown control is a combination of arrow buttons and a TextBox that allows users to select or input a numeric Value. Users can adjust the value by clicking the up/down arrows or by typing directly into the text box.

<!-- XAML -->
<hc:NumericUpDown Value="100"/>

<!-- C# -->
var numericUpDown = new NumericUpDown();
numericUpDown.Value = 100;

HandyControl is a project that has joined the dotNET China organization.

Key resources:

• Gitee Repository: https://gitee.com/handyorg/HandyControl/
• NuGet Package: HandyControl
• MyGet Feed: handycontrol

Requirements/Compatibility:

• .NET >= 4.0
• C# latest
• IDE: Visual Studio 2022

HandyControl provides loading animations to indicate progress during time-consuming operations. The library currently supports two types of loading indicators:

1. LoadingLine: A linear loading bar.
2. LoadingCircle: A circular loading animation.

Both types inherit from LoadingBase and are used to provide visual feedback to the user.

<!-- Example of using both types in a layout -->
<StackPanel>
    <hc:LoadingLine/>
    <hc:LoadingCircle/>
</StackPanel>

The GlowWindow is a specialized Window implementation that provides a glowing border effect around the window frame. The implementation logic is inspired by Visual Studio. You can customize the glow color for both active and inactive states using the ActiveGlowColor and InactiveGlowColor properties.

<hc:GlowWindow x:Class="HandyControlDemo.Window.GlowWindow"
               xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
               xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
               xmlns:hc="https://handyorg.github.io/handycontrol"
               Style="{StaticResource WindowGlow}"
               ActiveGlowColor="{DynamicResource PrimaryColor}"
               Height="450" 
               Width="800">
    <Border Background="{DynamicResource MainContentForegroundDrawingBrush}"/>
</hc:GlowWindow>

The CirclePanel is a specialized Panel designed to arrange child elements in a circular pattern. It is commonly used as a container for directional buttons or functional icon buttons arranged around a center point.

Inherits from: public class CirclePanel : Panel

<hc:CirclePanel Margin="64" Diameter="170">
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
    <Button Style="{StaticResource CirclePanelButton}"/>
</hc:CirclePanel>

HandyControl provides three built-in XAML color configuration files. Each file defines the same set of color keys but uses different color values. Choose the file that matches your desired application theme:

• Colors.xaml: Default configuration.
• ColorsDark.xaml: Dark theme configuration.
• ColorsViolet.xaml: Violet theme configuration.

The PreviewSlider is an extension of the standard Slider that allows you to provide visual feedback to users about state information at different positions along the slider track. It uses PreviewContent to render custom UI elements that follow the slider's position.

<hc:PreviewSlider Name="PreviewSliderHorizontal" Width="300" Value="500" Maximum="1000">
    <hc:PreviewSlider.PreviewContent>
        <Label Style="{StaticResource LabelPrimary}" 
                Content="{Binding Path=(hc:PreviewSlider.PreviewPosition), RelativeSource={RelativeSource Self}}" 
                ContentStringFormat="#0.00"/>
    </hc:PreviewSlider.PreviewContent>
</hc:PreviewSlider>

The RunningBlock control is used to create a continuous carousel or marquee effect for scrolling content. It inherits from ContentControl and can contain text or complex layouts like a StackPanel containing images.

<hc:RunningBlock>
    <StackPanel Orientation="Horizontal">
        <!-- Your scrolling content here -->
    </StackPanel>
</hc:RunningBlock>

The Divider control is used to separate content within a UI. It can be used as a simple line or as a line containing text content. You can control its orientation (horizontal or vertical), thickness, color, and dash patterns.

<hc:Divider/>