### FAQ: Using the Ask Method

Source: https://handyorg.github.io/handycontrol/extend_controls/growl

Explanation and example of how to use the `Ask` method for user confirmation.

```APIDOC
## FAQ: Using the Ask Method

### Description

The `Ask` method is used to display a notification that requires user confirmation. It presents 'Confirm' and 'Cancel' buttons. The behavior after the user interacts with these buttons is determined by a callback function.

### Callback Function

The second parameter of the `Ask` method is a `Func<bool, bool>`. This function receives a boolean value indicating the user's choice: `true` if 'Confirm' was clicked, `false` if 'Cancel' was clicked. The function should return `true` to close the Growl notification after the action, or `false` to keep it open.

### Example

```csharp
Growl.Ask(Properties.Langs.Lang.GrowlAsk, isConfirmed =>
{
    Growl.Info(isConfirmed.ToString()); // Display user's choice
    return true; // Close the Growl notification after the action
});
```

In this example, if the user confirms, a message indicating `true` will be shown, and the Growl notification will close. If the user cancels, a message indicating `false` will be shown, and the Growl notification will also close because the callback returns `true`.
```

--------------------------------

### Basic Dialog Usage

Source: https://handyorg.github.io/handycontrol/extend_controls/dialog

Example of how to show a custom dialog by providing its class name.

```APIDOC
## Basic Dialog Usage

### Example
```csharp
Dialog.Show(new TextDialog());
```

This example demonstrates showing a `TextDialog` instance. The `TextDialog` is a custom user control defined elsewhere.
```

--------------------------------

### Basic ComboBox Examples

Source: https://handyorg.github.io/handycontrol/extend_controls/comboBox

Demonstrates basic ComboBox usage with ShowClearButton, ItemsSource, SelectedIndex, and IsEnabled properties.

```xaml
<hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" SelectedIndex="0"/>  
<hc:ComboBox ItemsSource="{Binding DataList}" Margin="0,16,0,0" SelectedIndex="0" IsEnabled="False"/>  
<hc:ComboBox ShowClearButton="True" ItemsSource="{Binding DataList}" SelectedIndex="0" Margin="0,16,0,0" IsEditable="True"/>  
```

--------------------------------

### FloatingBlock Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/floatingBlock

Demonstrates how to use the FloatingBlock control with different configurations for click effects. It shows examples using ContentTemplate and direct Content property.

```xaml
<StackPanel Margin="32" VerticalAlignment="Center">
    <Button hc:IconElement.Geometry="{StaticResource ThumbsUpGeometry}" Width="180">
        <hc:FloatingBlock.ContentTemplate>
            <DataTemplate>
                <Path Data="{StaticResource ThumbsUpGeometry}" Fill="{DynamicResource DangerBrush}" Width="16" Height="16"/>
            </DataTemplate>
        </hc:FloatingBlock.ContentTemplate>
    </Button>
    <Button Content="Good" hc:FloatingBlock.Content="Good" Width="180" Margin="0,10,0,0"/>
    <Button hc:IconElement.Geometry="{StaticResource ThumbsUpGeometry}" Width="180" Margin="0,10,0,0" hc:FloatingBlock.Duration="0:0:1" hc:FloatingBlock.VerticalOffset="-20" hc:FloatingBlock.ToX="50" hc:FloatingBlock.ToY="-80">
        <hc:FloatingBlock.ContentTemplate>
            <DataTemplate>
                <Path Data="{StaticResource ThumbsUpGeometry}" Fill="{DynamicResource DangerBrush}" Width="16" Height="16"/>
            </DataTemplate>
        </hc:FloatingBlock.ContentTemplate>
    </Button>
</StackPanel>
```

--------------------------------

### Basic TabControl Example

Source: https://handyorg.github.io/handycontrol/native_controls/tabControl

Demonstrates the default TabControl with multiple tab items. This is a foundational example for using the TabControl.

```xaml
<TabControl Margin="10">
    <TabItem Header="选项卡1">
    </TabItem>
    <TabItem Header="选项卡2">
    </TabItem>
    <TabItem Header="选项卡3">
    </TabItem>
</TabControl>
```

--------------------------------

### NotifyIcon Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/notifyIcon

An example demonstrating how to use the NotifyIcon control in XAML.

```APIDOC
## NotifyIcon Usage Example

### Description
This example shows how to declare and configure a NotifyIcon in XAML.

### XAML
```xml
<hc:NotifyIcon Text="HandyControl"
               IsBlink="true"
               Visibility="Visible"
               Icon="/HandyControlDemo;component/Resources/Img/icon-white.ico"/>
```
```

--------------------------------

### Adding and Jumping in CoverFlow

Source: https://handyorg.github.io/handycontrol/extend_controls/coverFlow

Example demonstrating how to add resources and jump to a specific page in the CoverFlow control.

```APIDOC
## Example: Adding and Jumping

### Description
This example shows how to populate the CoverFlow with multiple image resources and then navigate to a specific item.

### Code
```csharp
CoverFlowMain.AddRange(new []
{
    new Uri(@"pack://application:,,,/Resources/Img/Album/1.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/2.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/3.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/4.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/5.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/6.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/7.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/8.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/9.jpg"),
    new Uri(@"pack://application:,,,/Resources/Img/Album/10.jpg")
});
CoverFlowMain.JumpTo(2);
```
```

--------------------------------

### TextBlock Styles Example

Source: https://handyorg.github.io/handycontrol/native_controls/textBlock

Demonstrates the usage of various predefined TextBlock styles for different text hierarchies and semantic meanings.

```XAML
<StackPanel>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockLargeBold" Style="{StaticResource TextBlockLargeBold}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockLarge" Style="{StaticResource TextBlockLarge}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockHeaderBold" Style="{StaticResource TextBlockTitleBold}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockHeader" Style="{StaticResource TextBlockTitle}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockSubHeaderBold" Style="{StaticResource TextBlockSubTitleBold}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockSubHeader" Style="{StaticResource TextBlockSubTitle}"/>

    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultBold" Style="{StaticResource TextBlockDefaultBold}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefault" Style="{StaticResource TextBlockDefault}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultAccent" Style="{StaticResource TextBlockDefaultAccent}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultSecLight" Style="{StaticResource TextBlockDefaultSecLight}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultThiLight" Style="{StaticResource TextBlockDefaultThiLight}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultPrimary" Style="{StaticResource TextBlockDefaultPrimary}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultDanger" Style="{StaticResource TextBlockDefaultDanger}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultWarning" Style="{StaticResource TextBlockDefaultWarning}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultInfo" Style="{StaticResource TextBlockDefaultInfo}"/>
    <TextBlock HorizontalAlignment="Left" Margin="5" Text="TextBlockDefaultSuccess" Style="{StaticResource TextBlockDefaultSuccess}"/>
</StackPanel>
```

--------------------------------

### Gravatar Control Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/gravatar

Demonstrates various ways to use the Gravatar control within a StackPanel and UniformGrid. Includes examples of setting Id, Style, and Source properties, as well as binding the Id to a TextBox.

```xaml
<StackPanel Margin="32" Orientation="Horizontal">
    <UniformGrid Rows="3" Columns="3" Width="240" Height="240">
        <hc:Gravatar Id="User1"/>
        <hc:Gravatar Id="User2"/>
        <hc:Gravatar Style="{StaticResource GravatarCircleImg}">
            <Image Source="/HandyControlDemo;component/Resources/Img/Album/2.jpg"/>
        </hc:Gravatar>
        <hc:Gravatar Id="User4"/>
        <hc:Gravatar Id="User5" Style="{StaticResource GravatarCircle}"/>
        <hc:Gravatar Id="User6"/>
        <hc:Gravatar Style="{StaticResource GravatarCircle}" Source="/HandyControlDemo;component/Resources/Img/Album/1.jpg"/>
        <hc:Gravatar Id="User8"/>
        <hc:Gravatar Id="User9"/>
    </UniformGrid>
    <StackPanel Margin="16,0,0,0" Height="220" VerticalAlignment="Center">
        <TextBox Text="User1" Name="TextBoxName" Width="180"/>
        <hc:Gravatar Height="180" Width="180" Id="{Binding Text,ElementName=TextBoxName}" Margin="10"/>
    </StackPanel>
</StackPanel>
```

--------------------------------

### CompareSlider Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/compareSlider

Demonstrates how to use the CompareSlider control to display image differences. Includes horizontal and vertical orientations.

```xaml
<WrapPanel ItemHeight="384" ItemWidth="632">
    <hc:CompareSlider Value="5" Width="600" Height="352">
        <hc:CompareSlider.TargetContent>
            <Border>
                <Border.Background>
                    <ImageBrush ImageSource="/HandyControlDemo;component/Resources/Img/b1.jpg"/>
                </Border.Background>
            </Border>
        </hc:CompareSlider.TargetContent>
        <hc:CompareSlider.SourceContent>
            <Border>
                <Border.Background>
                    <ImageBrush ImageSource="/HandyControlDemo;component/Resources/Img/b2.jpg"/>
                </Border.Background>
            </Border>
        </hc:CompareSlider.SourceContent>
    </hc:CompareSlider>
    <hc:CompareSlider Orientation="Vertical" Value="5" Width="600" Height="352">
        <hc:CompareSlider.TargetContent>
            <Border>
                <Border.Background>
                    <ImageBrush ImageSource="/HandyControlDemo;component/Resources/Img/b1.jpg"/>
                </Border.Background>
            </Border>
        </hc:CompareSlider.TargetContent>
        <hc:CompareSlider.SourceContent>
            <Border>
                <Border.Background>
                    <ImageBrush ImageSource="/HandyControlDemo;component/Resources/Img/b2.jpg"/>
                </Border.Background>
            </Border>
        </hc:CompareSlider.SourceContent>
    </hc:CompareSlider>
</WrapPanel>
```

--------------------------------

### Rate Control Examples

Source: https://handyorg.github.io/handycontrol/extend_controls/rate

Demonstrates various configurations of the Rate control, including default values, read-only mode, half-selection, clearing behavior, custom icons, and displaying text.

```xaml
<StackPanel Width="170">
    <hc:Rate Value="2"/>
    <hc:Rate Value="5" Count="6" Margin="0,16,0,0" Foreground="{DynamicResource SuccessBrush}"/>
    <hc:Rate DefaultValue="3" IsReadOnly="True" AllowHalf="True" Margin="0,16,0,0" Foreground="{DynamicResource WarningBrush}"/>
    <hc:Rate DefaultValue="1" AllowClear="False" AllowHalf="True" Margin="0,16,0,0" Foreground="{DynamicResource DangerBrush}" Icon="{StaticResource LoveGeometry}"/>
    <hc:Rate Value="4.5" AllowHalf="True" ShowText="True" Margin="0,16,0,0" Foreground="{DynamicResource DangerBrush}" Icon="{StaticResource LoveGeometry}"/>
</StackPanel>
```

--------------------------------

### TabControl Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/tabControl

Demonstrates how to use the TabControl with various properties enabled, including animations, close buttons, draggable tabs, and tab filling. This example showcases a TabControl with seven TabItems, each containing a SimplePanel with a different background color.

```xaml
1  
2  
3  
4  
5  
6  
7  
8  
9  
10  
11  
12  
13  
14  
15  
16  
17  
18  
19  
20  
21  
22  
23  


```

```xaml
<hc:TabControl IsAnimationEnabled="True" ShowCloseButton="True" IsDraggable="True" IsTabFillEnabled="True" Width="800" Height="300">
    <hc:TabItem Header="TabItem1">
        <hc:SimplePanel Background="{DynamicResource RegionBrush}"/>
    </hc:TabItem>
    <hc:TabItem IsSelected="True" Header="TabItem2">
        <hc:SimplePanel Background="#FFE8563F"/>
    </hc:TabItem>
    <hc:TabItem Header="TabItem3">
        <hc:SimplePanel Background="#FF3F4EE8"/>
    </hc:TabItem>
    <hc:TabItem Header="TabItem4">
        <hc:SimplePanel Background="#FFE83F6D"/>
    </hc:TabItem>
    <hc:TabItem Header="TabItem5">
        <hc:SimplePanel Background="#FFB23FE8"/>
    </hc:TabItem>
    <hc:TabItem Header="TabItem6">
        <hc:SimplePanel Background="#FF3FE8E8"/>
    </hc:TabItem>
    <hc:TabItem Header="TabItem7">
        <hc:SimplePanel Background="#FFE8E03F"/>
    </hc:TabItem>
</hc:TabControl>


```

--------------------------------

### Shield Badge Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/shield

Demonstrates how to use the Shield badge component with different subjects, statuses, colors, and click commands to open links.

```xaml
<StackPanel Orientation="Horizontal" Margin="32">
    <hc:Shield Subject=".net" Status=">=4.0" Color="#1182c3"/>
    <hc:Shield Subject="c#" Status="7.0" Margin="4,0,0,0" Color="#1182c3"/>
    <hc:Shield Subject="IDE" Status="2017" Margin="4,0,0,0" Color="#1182c3"/>
    <hc:Shield Subject="chat" Status="on gitter" Margin="4,0,0,0" Color="#4eb899" Command="hc:ControlCommands.OpenLink" CommandParameter="https://gitter.im/HandyControl/Lobby?utm_source=badge&amp;utm_medium=badge&amp;utm_campaign=pr-badge&amp;utm_content=badge"/>
    <hc:Shield Subject="qq" Status="714704041" Margin="4,0,0,0" Color="#d8624c" Command="hc:ControlCommands.OpenLink" CommandParameter="http://shang.qq.com/wpa/qunwpa?idkey=a571e5553c9d41e49c4f22f3a8b2865451497a795ff281fedf3285def247efc1"/>
</StackPanel>
```

--------------------------------

### CircleProgressBar Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/circleProgressBar

Demonstrates various configurations of CircleProgressBar, including different sizes, text visibility, arc thickness, and styles for different states.

```xaml
1  
2  
3  
4  
5  
6  
7  
8  


```
<StackPanel Orientation="Horizontal" Margin="0,32,0,0">
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}"/>
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" FontSize="30" Margin="16,0,0,0"/>
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="20" Height="20" ArcThickness="2" Style="{StaticResource ProgressBarSuccessCircle}"/>
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="30" Height="30" ArcThickness="6" Style="{StaticResource ProgressBarInfoCircle}"/>
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" ShowText="False" Width="40" Height="40" ArcThickness="10" Style="{StaticResource ProgressBarWarningCircle}"/>
    <hc:CircleProgressBar Value="{Binding Value,ElementName=SliderDemo}" Margin="16,0,0,0" Width="50" Height="50" Style="{StaticResource ProgressBarDangerCircle}"/>
</StackPanel>

```
```

--------------------------------

### HoneycombPanel Layout Example

Source: https://handyorg.github.io/handycontrol/extend_controls/honeycombPanel

Illustrates the circular arrangement of elements around a central point in a honeycomb layout.

```plaintext
         ●       ●  
        (7)     (8)  
  
     ●       ●       ●  
    (6)     (1)     (9)  
  
 ●       ●       ●       ...  
(5)     (0)     (2)  
  
     ●       ●       ...  
    (4)     (3)
```

--------------------------------

### Brush Resource for IconBrushKey

Source: https://handyorg.github.io/handycontrol/data/GrowlInfo

Example of a Brush resource that can be used for the IconBrushKey property in GrowlInfo. Ensure the resource type is Brush and the Key name is correctly specified.

```xml
<LinearGradientBrush x:Key="ToolBarBackground" EndPoint="0.5,1" StartPoint="0.5,0">
    <GradientStop Color="#F5F4F5" Offset="0"/>
    <GradientStop Color="#D1CFD1" Offset="1"/>
</LinearGradientBrush>
```

--------------------------------

### Example Usage of Boolean to Visibility Converter

Source: https://handyorg.github.io/handycontrol/basic_xaml/converters

Demonstrates how to use the `Boolean2VisibilityConverter` in XAML to control element visibility based on a boolean binding.

```XAML
Visibility="{Binding ShowButton,Converter={StaticResource Boolean2VisibilityConverter}}"
```

--------------------------------

### Geometry Resource for IconKey

Source: https://handyorg.github.io/handycontrol/data/GrowlInfo

Example of a Geometry resource that can be used for the IconKey property in GrowlInfo. Ensure the resource type is Geometry and the Key name is correctly specified.

```xml
<Geometry x:Key="GitterGeometry">M260.8 645H160V0h100.8v645zM461.8 152.2h-100.8V1024h100.8V152.2z m201.2 0h-100.8V1024h100.8V152.2zM864 152h-100.8v494H864V152z</Geometry>
```

--------------------------------

### Defining a Geometry for AnimationPath

Source: https://handyorg.github.io/handycontrol/extend_controls/animationPath

Example of defining a Geometry resource named 'GithubGeometry' which can be used by the AnimationPath control.

```xaml
<Geometry x:Key="GithubGeometry">M512 0C229.12 0 0 229.12 0 512c0 226.56 146.56 417.92 350.08 485.76 25.6 4.48 35.2-10.88 35.2-24.32 0-12.16-0.64-52.48-0.64-95.36-128.64 23.68-161.92-31.36-172.16-60.16-5.76-14.72-30.72-60.16-52.48-72.32-17.92-9.6-43.52-33.28-0.64-33.92 40.32-0.64 69.12 37.12 78.72 52.48 46.08 77.44 119.68 55.68 149.12 42.24 4.48-33.28 17.92-55.68 32.64-68.48-113.92-12.8-232.96-56.96-232.96-252.8 0-55.68 19.84-101.76 52.48-137.6-5.12-12.8-23.04-65.28 5.12-135.68 0 0 42.88-13.44 140.8 52.48 40.96-11.52 84.48-17.28 128-17.28 43.52 0 87.04 5.76 128 17.28 97.92-66.56 140.8-52.48 140.8-52.48 28.16 70.4 10.24 122.88 5.12 135.68 32.64 35.84 52.48 81.28 52.48 137.6 0 196.48-119.68 240-233.6 252.8 18.56 16 34.56 46.72 34.56 94.72 0 68.48-0.64 123.52-0.64 140.8 0 13.44 9.6 29.44 35.2 24.32A512.832 512.832 0 0 0 1024 512c0-282.88-229.12-512-512-512z</Geometry>
```

--------------------------------

### DashedBorder Example

Source: https://handyorg.github.io/handycontrol/extend_controls/dashedBorder

Demonstrates how to use the DashedBorder control in XAML with specific styling for width, height, border dash thickness, color, dash array, and corner radius.

```APIDOC
## DashedBorder Example

### Description
Shows a practical example of implementing the DashedBorder control with various customization properties.

### Usage
```xml
<hc:DashedBorder Width="100" Height="100" BorderDashThickness="2" BorderBrush="Black" BorderDashArray="3, 1" CornerRadius="0,50,0,0"/>
```

### Notes
- When setting the border thickness, use `BorderThickness` if all corner radius values are the same.
- Use `BorderDashThickness` if the corner radius values differ.
```

--------------------------------

### Using AnimationPath in XAML

Source: https://handyorg.github.io/handycontrol/extend_controls/animationPath

Example of how to use the AnimationPath control within a Grid, binding its Data property to a Geometry resource and setting the Duration.

```xaml
<Grid Width="100" Height="100">
    <hc:AnimationPath Data="{DynamicResource GithubGeometry}" 
                          Duration="00:00:05" 
                          Stretch="Uniform" StrokeThickness="1"
                          Stroke="Black"></hc:AnimationPath>
</Grid>
```

--------------------------------

### TagPanel Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/tag

Demonstrates the usage of TagPanel with various Tag controls. It shows how to configure the panel's orientation, maximum width, alignment, and whether to show an add button. Individual tags can be configured for selectable state and visibility of their close buttons.

```xaml
<hc:TagPanel AddTagButtonClick="TagPanel_OnAddTagButtonClick" Margin="32" Orientation="Horizontal" MaxWidth="400" VerticalAlignment="Center" ShowAddButton="True">
    <hc:Tag ShowCloseButton="False" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=2}"/>
    <hc:Tag Selectable="True" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=3}"/>
    <hc:Tag ShowCloseButton="False" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=4}"/>
    <hc:Tag Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=5}"/>
    <hc:Tag IsSelected="True" Selectable="True" ShowCloseButton="False" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=4}"/>
    <hc:Tag Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=3}"/>
    <hc:Tag ShowCloseButton="False" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=2}"/>
    <hc:Tag IsSelected="True" Selectable="True" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=3}"/>
    <hc:Tag ShowCloseButton="False" Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=4}"/>
    <hc:Tag Content="{ex:Lang Key={x:Static langs:LangKeys.Text}, Converter={StaticResource StringRepeatConverter}, ConverterParameter=5}"/>
</hc:TagPanel>
```

--------------------------------

### Show Dialog and Get Result Asynchronously

Source: https://handyorg.github.io/handycontrol/extend_controls/dialog

Shows a dialog and waits for an asynchronous result. The Initialize method sets up the ViewModel, and GetResultAsync retrieves the result.

```csharp
Dialog.Show<InteractiveDialog>()
    .Initialize<InteractiveDialogViewModel>(vm => vm.Message = DialogResult)
    .GetResultAsync<string>()
    .ContinueWith(str => DialogResult = str.Result);
```

--------------------------------

### CirclePanel Usage Example

Source: https://handyorg.github.io/handycontrol/extend_controls/circlePanel

Demonstrates how to use the CirclePanel to arrange multiple buttons in a circular layout. The Diameter property controls the size of the circle.

```xaml
<Style x:Key="CirclePanelButton" BasedOn="{StaticResource ButtonCustom}" TargetType="Button">
    <Setter Property="UseLayoutRounding" Value="False"/>
    <Setter Property="Height" Value="77"/>
    <Setter Property="Width" Value="36.06"/>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="Button">
                <hc:SimplePanel>
                    <Path Data="{StaticResource CirclePanelDemoGeometry}" Fill="{DynamicResource PrimaryBrush}" Height="77" Width="36.06"/>
                    <Path Data="{StaticResource CirclePanelRightGeometry}" Stretch="Uniform" Margin="12" Fill="White"/>
                </hc:SimplePanel>
                <ControlTemplate.Triggers>
                    <Trigger Property="IsMouseOver" Value="True">
                        <Setter Property="Opacity" Value=".9"/>
                    </Trigger>
                    <Trigger Property="IsPressed" Value="True">
                        <Setter Property="Opacity" Value=".6"/>
                    </Trigger>
                    <Trigger Property="IsEnabled" Value="False">
                        <Setter Property="Opacity" Value="0.4"/>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

<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>
```

--------------------------------

### Basic Growl Container Setup

Source: https://handyorg.github.io/handycontrol/extend_controls/growl

Designate a StackPanel as the Growl notification container by setting the `controls:Growl.GrowlParent` attached property to `True`. This tells Growl to use this specific panel for displaying notifications.

```xaml
<ScrollViewer VerticalScrollBarVisibility="Hidden" HorizontalAlignment="Right">
    <StackPanel controls:Growl.GrowlParent="True" VerticalAlignment="Top" Margin="0,10,10,10"/>
</ScrollViewer>
```

--------------------------------

### Interactive Ask Notification Example

Source: https://handyorg.github.io/handycontrol/extend_controls/growl

The `Growl.Ask()` method displays a notification with 'Confirm' and 'Cancel' buttons. The `Func<bool, bool>` parameter handles the user's choice. Returning `true` closes the notification; `false` keeps it open.

```csharp
Growl.Ask(Properties.Langs.Lang.GrowlAsk, isConfirmed =>
{
    Growl.Info(isConfirmed.ToString());
    return true;
});
```

--------------------------------

### ToggleButtonFlip Example

Source: https://handyorg.github.io/handycontrol/native_controls/toggleButton

Demonstrates the ToggleButtonFlip style for creating a flip-style toggle button with custom content for checked and unchecked states. Use this for a visual switch with distinct 'on' and 'off' appearances.

```XAML
<StackPanel VerticalAlignment="Center" HorizontalAlignment="Center">
    <ToggleButton BorderThickness="0" IsChecked="True" Style="{StaticResource ToggleButtonFlip}">
        <hc:StatusSwitchElement.CheckedElement>
            <Border Background="{DynamicResource PrimaryBrush}">
                <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Text="关" Foreground="{DynamicResource TextIconBrush}"/>
            </Border>
        </hc:StatusSwitchElement.CheckedElement>
        <Border Background="{DynamicResource DangerBrush}">
            <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Text="开" Foreground="{DynamicResource TextIconBrush}"/>
        </Border>
    </ToggleButton>
    <ToggleButton Margin="0,6,0,0" BorderThickness="0" IsChecked="False" Style="{StaticResource ToggleButtonFlip}">
        <hc:StatusSwitchElement.CheckedElement>
            <Border Background="{DynamicResource PrimaryBrush}">
                <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Text="关" Foreground="{DynamicResource TextIconBrush}"/>
            </Border>
        </hc:StatusSwitchElement.CheckedElement>
        <Border Background="{DynamicResource DangerBrush}">
            <TextBlock HorizontalAlignment="Center" VerticalAlignment="Center" Text="开" Foreground="{DynamicResource TextIconBrush}"/>
        </Border>
    </ToggleButton>
</StackPanel>
```

--------------------------------

### ToggleButtonCustom Example

Source: https://handyorg.github.io/handycontrol/native_controls/toggleButton

Illustrates the ToggleButtonCustom style for fully custom toggle button content. Use this when you need complete control over the appearance of both the checked and unchecked states, including complex elements.

```XAML
<StackPanel VerticalAlignment="Center" HorizontalAlignment="Center">
    <ToggleButton IsChecked="True" Style="{StaticResource ToggleButtonCustom}" hc:StatusSwitchElement.HideUncheckedElement="True">
        <hc:StatusSwitchElement.CheckedElement>
            <Border Width="80" Height="30" CornerRadius="4" BorderThickness="1" BorderBrush="{DynamicResource BorderBrush}">
                <Ellipse Width="20" Height="20" Fill="{DynamicResource PrimaryBrush}" StrokeThickness="1" Stroke="{DynamicResource BorderBrush}"/>
            </Border>
        </hc:StatusSwitchElement.CheckedElement>
        <Border Width="80" Height="30" CornerRadius="4" BorderThickness="1" BorderBrush="{DynamicResource BorderBrush}">
            <Ellipse Width="20" Height="20" Fill="{DynamicResource BorderBrush}" StrokeThickness="1" Stroke="{DynamicResource BorderBrush}"/>
        </Border>
    </ToggleButton>
    <ToggleButton Margin="0,6,0,0" IsChecked="False" Style="{StaticResource ToggleButtonCustom}" hc:StatusSwitchElement.HideUncheckedElement="True">
        <hc:StatusSwitchElement.CheckedElement>
            <Border Width="80" Height="30" CornerRadius="4" BorderThickness="1" BorderBrush="{DynamicResource BorderBrush}">
                <Ellipse Width="20" Height="20" Fill="{DynamicResource PrimaryBrush}" StrokeThickness="1" Stroke="{DynamicResource BorderBrush}"/>
            </Border>
        </hc:StatusSwitchElement.CheckedElement>
        <Border Width="80" Height="30" CornerRadius="4" BorderThickness="1" BorderBrush="{DynamicResource BorderBrush}">
            <Ellipse Width="20" Height="20" Fill="{DynamicResource BorderBrush}" StrokeThickness="1" Stroke="{DynamicResource BorderBrush}"/>
        </Border>
    </ToggleButton>
</StackPanel>
```

--------------------------------

### Adding a Symbol to a Required SearchBar

Source: https://handyorg.github.io/handycontrol/attach/infoElement

Illustrates adding a symbol (e.g., 'x') to a SearchBar that is marked as necessary, providing a visual cue to the user. This example also sets a placeholder and title.

```XAML
<hc:SearchBar hc:InfoElement.Placeholder="请输入内容" 
          hc:InfoElement.Title="此项必填" Style="{StaticResource SearchBarExtend}" 
          Margin="10,10" hc:InfoElement.Necessary="True" 
          hc:InfoElement.Symbol="x"/>
```

--------------------------------

### ImageSelector XAML Usage Examples

Source: https://handyorg.github.io/handycontrol/extend_controls/imageSelector

Demonstrates various ways to use the ImageSelector control in XAML, showcasing different styling options like corner radius, stroke dash array, and border brush.

```xaml
<UniformGrid Columns="3" Margin="16">
    <hc:ImageSelector Width="100" Height="100" Margin="16"/>
    <hc:ImageSelector Width="100" Height="100" Margin="16" hc:BorderElement.CornerRadius="50"/>
    <hc:ImageSelector Width="100" Height="100" Margin="16" hc:BorderElement.CornerRadius="50" StrokeDashArray="10,5"/>
    <hc:ImageSelector Width="100" Height="100" Margin="16" hc:BorderElement.CornerRadius="50" BorderBrush="{DynamicResource SuccessBrush}"/>
    <hc:ImageSelector Width="100" Height="100" Margin="16" hc:BorderElement.CornerRadius="50" StrokeDashArray="10,5,10" BorderBrush="{DynamicResource DangerBrush}"/>
    <hc:ImageSelector Width="100" Height="100" Margin="16" hc:BorderElement.CornerRadius="10" StrokeThickness="2" BorderThickness="2" BorderBrush="{DynamicResource PrimaryBrush}"/>
</UniformGrid>
```

--------------------------------

### Instantiate and Show ImageBrowser

Source: https://handyorg.github.io/handycontrol/extend_controls/imageBrowser

Demonstrates how to create an instance of ImageBrowser by providing a Uri to an image file and then displaying it.

```csharp
new ImageBrowser(new Uri("pack://application:,,,/Resources/Img/1.jpg")).Show()
```

--------------------------------

### PropertyGrid Initialization with Demo Model

Source: https://handyorg.github.io/handycontrol/extend_controls/propertyGrid

Initializes an instance of the PropertyGridDemoModel with sample data for demonstration purposes.

```csharp
1  
2  
3  
4  
5  
6  
7  
8  

```
DemoModel = new PropertyGridDemoModel  
{
    String = "TestString",
    Enum = Gender.Female,
    Boolean = true,
    Integer = 98,
    VerticalAlignment = VerticalAlignment.Stretch
};

```
```

--------------------------------

### Basic Usage

Source: https://handyorg.github.io/handycontrol/extend_controls/growl

This section explains how to set up a StackPanel as a Growl container and display a success message.

```APIDOC
## Basic Usage

### Description

To use Growl notifications, first designate a `StackPanel` as the container for these notifications by setting the `controls:Growl.GrowlParent="True"` attached property in XAML.

### XAML Setup
```xml
<ScrollViewer VerticalScrollBarVisibility="Hidden" HorizontalAlignment="Right">
    <StackPanel controls:Growl.GrowlParent="True" VerticalAlignment="Top" Margin="0,10,10,10"/>
</ScrollViewer>
```

### Code Example

After setting up the container, you can display messages using static methods of the `Growl` class.

```csharp
Growl.Success("文件保存成功！");
```
```

--------------------------------

### Create DatePicker Instance

Source: https://handyorg.github.io/handycontrol/extend_controls/datePicker

Demonstrates how to create a DatePicker control instance in XAML and C#.

```xaml
<hc:DatePicker />


```

```csharp
var datePicker = new DatePicker();


```

--------------------------------

### Show Basic Dialog

Source: https://handyorg.github.io/handycontrol/extend_controls/dialog

Demonstrates how to display a custom dialog by passing an instance of the dialog content to the Show method.

```csharp
Dialog.Show(new TextDialog());
```

--------------------------------

### StepBar Basic Usage

Source: https://handyorg.github.io/handycontrol/extend_controls/stepBar

Demonstrates the basic structure of a StepBar with predefined steps. Use this for simple sequential task flows.

```xaml
<Grid Margin="32">
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="Auto"/>
    </Grid.RowDefinitions>
    <Grid.ColumnDefinitions>
        <ColumnDefinition/>
        <ColumnDefinition/>
    </Grid.ColumnDefinitions>
    <hc:StepBar Grid.ColumnSpan="2" StepIndex="{Binding StepIndex}">
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.Register}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.BasicInfo}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.UploadFile}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.Complete}}"/>
    </hc:StepBar>
    <StackPanel Margin="0,32" Grid.Column="0" Grid.Row="1" Grid.ColumnSpan="2" HorizontalAlignment="Center">
        <Button Command="{Binding PrevCmd}" CommandParameter="{Binding ElementName=PanelMain}" Width="180" Content="{ex:Lang Key={x:Static langs:LangKeys.Prev}}" Style="{StaticResource ButtonPrimary}"/>
        <Button Command="{Binding NextCmd}" CommandParameter="{Binding ElementName=PanelMain}" Width="180" Margin="0,16,0,0" Content="{ex:Lang Key={x:Static langs:LangKeys.Next}}" Style="{StaticResource ButtonPrimary}"/>
    </StackPanel>
    <hc:StepBar Margin="0,0,0,32" Grid.Column="0" Grid.Row="2" Grid.ColumnSpan="2" Dock="Bottom">
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.Register}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.BasicInfo}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.UploadFile}}"/>
        <hc:StepBarItem Content="{ex:Lang Key={x:Static langs:LangKeys.Complete}}"/>
    </hc:StepBar>
    <hc:StepBar Grid.Column="0" Grid.Row="3" ItemsSource="{Binding DataList}" Dock="Left">
        <hc:StepBar.ItemTemplate>
            <DataTemplate>
                <StackPanel>
                    <TextBlock FontSize="16" FontWeight="Bold" HorizontalAlignment="Left">
                        <Run Text="{ex:Lang Key={Binding Header}}"/>
                        <Run Text="{Binding Index,RelativeSource={RelativeSource AncestorType=hc:StepBarItem}}"/>
                    </TextBlock>
                    <TextBlock Margin="0,4,0,0" Text="{ex:Lang Key={Binding Content}}"/>
                </StackPanel>
            </DataTemplate>
        </hc:StepBar.ItemTemplate>
    </hc:StepBar>
    <hc:StepBar Grid.Column="1" Grid.Row="3" ItemsSource="{Binding DataList}" Dock="Right">
        <hc:StepBar.ItemTemplate>
            <DataTemplate>
                <StackPanel>
                    <TextBlock FontSize="16" FontWeight="Bold" HorizontalAlignment="Left">
                        <Run Text="{ex:Lang Key={Binding Header}}"/>
                        <Run Text="{Binding Index,RelativeSource={RelativeSource AncestorType=hc:StepBarItem}}"/>
                    </TextBlock>
                    <TextBlock Margin="0,4,0,0" Text="{ex:Lang Key={Binding Content}}"/>
                </StackPanel>
            </DataTemplate>
        </hc:StepBar.ItemTemplate>
    </hc:StepBar>
</Grid>
```

--------------------------------

### Basic Button Usage

Source: https://handyorg.github.io/handycontrol/native_controls/button

Demonstrates the default button style and how to apply corner radius and icons.

```XAML
<StackPanel Orientation="Horizontal">
    <Button Content="这是一个按钮"/>
    <Button Content="这是一个按钮" Margin="10,0,0,0" controls:BorderElement.CornerRadius="15"/>
    <Button Content="这是一个按钮" Margin="10,0,0,0" controls:IconElement.Geometry="{StaticResource GithubGeometry}"/>
</StackPanel>
```

--------------------------------

### SearchBar Basic Usage

Source: https://handyorg.github.io/handycontrol/extend_controls/searchBar

Demonstrates basic SearchBar usage within a StackPanel, including binding to a command and setting a placeholder.

```xaml
<StackPanel Margin="32" Orientation="Horizontal">
    <StackPanel>
        <hc:SearchBar Command="{Binding SearchCmd}" CommandParameter="{Binding Text,RelativeSource={RelativeSource Self}}"/>
        <hc:SearchBar Margin="0,32,0,0" IsEnabled="False"/>

        <hc:SearchBar hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" Style="{StaticResource SearchBarExtend}"/>
        <hc:SearchBar hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" hc:InfoElement.Necessary="True" Style="{StaticResource SearchBarExtend}"/>
        <hc:SearchBar Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Style="{StaticResource SearchBarExtend}" Margin="0,32,0,0"/>
        <hc:SearchBar Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Style="{StaticResource SearchBarExtend}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
    </StackPanel>
    <StackPanel Margin="32,0,0,0">
        <hc:SearchBar Name="SearchBarCustomVerify" ShowClearButton="True" Style="{StaticResource SearchBarPlus}"/>
        <hc:SearchBar Margin="0,32,0,0" IsEnabled="False" Style="{StaticResource SearchBarPlus}"/>

        <hc:SearchBar ShowClearButton="True" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" Style="{StaticResource SearchBarPlus}"/>
        <hc:SearchBar TextType="Mail" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterEmail}}" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr1}}" Margin="0,32,0,0" hc:InfoElement.Necessary="True" Style="{StaticResource SearchBarPlus}"/>
        <hc:SearchBar Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Style="{StaticResource SearchBarPlus}" Margin="0,32,0,0"/>
        <hc:SearchBar ShowClearButton="True" Width="380" hc:InfoElement.TitleWidth="140" hc:InfoElement.Placeholder="{ex:Lang Key={x:Static langs:LangKeys.PlsEnterContent}}" hc:InfoElement.TitlePlacement="Left" hc:InfoElement.Title="{ex:Lang Key={x:Static langs:LangKeys.TitleDemoStr3}}" Style="{StaticResource SearchBarPlus}" hc:InfoElement.Necessary="True" Margin="0,32,0,0"/>
    </StackPanel>
</StackPanel>
```

--------------------------------

### Warning Button Style

Source: https://handyorg.github.io/handycontrol/native_controls/button

Shows the warning button style for cautionary actions, with examples of rounded corners and icons.

```XAML
<StackPanel Orientation="Horizontal">
    <Button Style="{StaticResource ButtonWarning}" Content="这是一个按钮"/>
    <Button Style="{StaticResource ButtonWarning}" Content="这是一个按钮" Margin="10,0,0,0" controls:BorderElement.CornerRadius="15"/>
    <Button Style="{StaticResource ButtonWarning}" Content="这是一个按钮" Margin="10,0,0,0" controls:IconElement.Geometry="{StaticResource GithubGeometry}"/>
</StackPanel>
```

--------------------------------

### Show Sprite with Custom Content

Source: https://handyorg.github.io/handycontrol/extend_controls/sprite

Demonstrates how to display a Sprite on the desktop with custom content. The Show method takes an object representing the content to be displayed.

```csharp
Sprite.Show(new AppSprite());
```

--------------------------------

### NotifyIcon XAML Usage

Source: https://handyorg.github.io/handycontrol/extend_controls/notifyIcon

Example of how to use the NotifyIcon control in XAML to display a system tray icon with a tooltip and blinking effect.

```xaml
<hc:NotifyIcon Text="HandyControl" IsBlink="true" Visibility="Visible" Icon="/HandyControlDemo;component/Resources/Img/icon-white.ico"/>  
```

--------------------------------

### Create TimePicker Instance

Source: https://handyorg.github.io/handycontrol/extend_controls/timePicker

Demonstrates how to create an instance of the TimePicker control in XAML and C#.

```xaml
<hc:TimePicker />
```

```csharp
var timePicker = new TimePicker();
```

--------------------------------

### Create a DateTimePicker Instance

Source: https://handyorg.github.io/handycontrol/extend_controls/dateTimePicker

Demonstrates how to create a new instance of the DateTimePicker control in code.

```csharp
var dateTimePicker = new DateTimePicker();
```

--------------------------------

### Asynchronous Dialog with Result

Source: https://handyorg.github.io/handycontrol/extend_controls/dialog

Demonstrates how to show a dialog, initialize its ViewModel, and asynchronously retrieve a result.

```APIDOC
## Asynchronous Dialog with Result

### Description
This example shows how to use the `Initialize` extension method to set up the ViewModel and `GetResultAsync` to wait for a result from the dialog.

### Example
```csharp
Dialog.Show<InteractiveDialog>()
    .Initialize<InteractiveDialogViewModel>(vm => vm.Message = DialogResult)
    .GetResultAsync<string>()
    .ContinueWith(str => DialogResult = str.Result);
```

This code snippet displays an `InteractiveDialog`, initializes its `InteractiveDialogViewModel` with a message, and then waits for a string result, assigning it to `DialogResult` upon completion.
```