詳解WPF中使用者控制元件和自定義控制元件的使用

2023-03-02 18:01:12

介紹

無論是在WPF中還是WinForm中，都有使用者控制元件（UserControl）和自定義控制元件（CustomControl），這兩種控制元件都是對已有控制元件的封裝，實現功能重用。但是兩者還是有一些區別，本文對這兩種控制元件進行講解。

1.使用者控制元件

注重複合控制元件的使用，也就是多個現有控制元件組成一個可複用的控制元件組
XAML和後臺程式碼組成，繫結緊密
不支援模板重寫
繼承自UserControl

2.自定義控制元件

完全自己實現一個控制元件，如繼承現有控制元件進行功能擴充套件，並新增新功能
後臺程式碼和Generic.xaml進行組合
在使用時支援模板重寫
繼承自Control

使用者控制元件

使用者控制元件比較容易理解，與常見的WPF表單類似，值得注意一點的地方是內部在使用繫結的時候，需要使用RelativeSource的方式來繫結，以實現良好的封裝。一個簡單的案例：

定義使用者控制元件

<UserControl
    x:Class="WpfApp19.UserControl1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
    xmlns:local="clr-namespace:WpfApp19"
    xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
    d:DesignHeight="450"
    d:DesignWidth="800"
    mc:Ignorable="d">
    <Grid>
        <!--下面繫結都要用RelativeSource作為源-->
        <StackPanel>
            <TextBox
                Width="100"
                BorderThickness="2"
                Text="{Binding value, RelativeSource={RelativeSource AncestorType=UserControl}}" />
            <Button
                Width="100"
                Command="{Binding Command, RelativeSource={RelativeSource AncestorType=UserControl}}"
                Content="Ok" />
        </StackPanel>
    </Grid>
</UserControl>

後臺程式碼

//根據需要定義依賴屬性 
//所需要繫結的值
 public int value
 {
     get { return (int)GetValue(valueProperty); }
     set { SetValue(valueProperty, value); }
 }
 public static readonly DependencyProperty valueProperty =
     DependencyProperty.Register("value", typeof(int), typeof(UserControl1), new PropertyMetadata(0));

 //所需要繫結的命令
 public ICommand Command
 {
     get { return (ICommand)GetValue(CommandProperty); }
     set { SetValue(CommandProperty, value); }
 }
 public static readonly DependencyProperty CommandProperty =
     DependencyProperty.Register("Command", typeof(ICommand), typeof(UserControl1), new PropertyMetadata(default(ICommand)));


 //所需要繫結的命令引數
 public object CommandParemeter
 {
     get { return (object)GetValue(CommandParemeterProperty); }
     set { SetValue(CommandParemeterProperty, value); }
 }
 public static readonly DependencyProperty CommandParemeterProperty =
     DependencyProperty.Register("CommandParemeter", typeof(object), typeof(UserControl1), new PropertyMetadata(0));

使用使用者控制元件

<Window x:Class="WpfApp19.MainWindow"
        ...
        xmlns:local="clr-namespace:WpfApp19"
        Title="MainWindow" Height="450" Width="800">
    <Grid>
        <local:UserControl1 value="{Binding }" Command="{Binding }"/>
    </Grid>
</Window>

自定義控制元件

點選新增自定義控制元件後，會增加一個CustomControl1.cs檔案以及一個Themes目錄，在該目錄下有一個Generic.xaml檔案，該檔案就是自定義控制元件的style。我們經常針對某些控制元件進行編輯模板-建立副本的操作而產生的style，其實就是Generic.xaml中定義的style。另外，有時我們可能遇到一種情況，也就是相同的軟體在不同的Windows版本下執行，表現形式可能會不同，甚至某些系統下執行不了，這就是和不同系統下的預設的Theme不同。其實wpf控制元件找不到自定義的樣式時，會從系統獲取樣式，查詢順序是，先查詢所在的程式集，如果程式集定義了ThemeInfo特性，那麼會檢視ThemeInfoDictionaryLocation的屬性值，該屬性如果是None則說明沒有特定的主題資源，值為SourceAssembly，說明特定資源定義在程式集內部，值為ExternalAssembly則說明在外部，如果還是沒有找到，則程式會在自身的themes/generic.xaml中獲取，在generic.xaml中獲取的其實就和系統預設樣式相關。

不同xaml所對應的系統主題

按鈕案例

C#檔案

public class Switch : ToggleButton
{
    static Switch()
    {
        //通過重寫Metadata，控制元件就會通過程式集themes資料夾下的generic.xaml來尋找系統預設樣式
        DefaultStyleKeyProperty.OverrideMetadata(typeof(Switch), new FrameworkPropertyMetadata(typeof(Switch)));
    }
}

Themes資料夾下的Generic.xaml檔案

注意在該檔案中不能有中文，註釋也不行

<Style TargetType="{x:Type local:Switch}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:Switch}">
                <Grid>
                    <Border
                        Name="dropdown"
                        Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"
                        Margin="-23"
                        CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"
                        Visibility="Collapsed">
                        <Border.Background>
                            <RadialGradientBrush>
                                <GradientStop Offset="1" Color="Transparent" />
                                <GradientStop Offset="0.7" Color="#5500D787" />
                                <GradientStop Offset="0.59" Color="Transparent" />
                            </RadialGradientBrush>
                        </Border.Background>
                    </Border>
                    <Border
                        Name="bor"
                        Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"
                        Background="Gray"
                        BorderBrush="DarkGreen"
                        BorderThickness="5"
                        CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}">
                        <Border
                            Name="bor1"
                            Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"
                            Margin="2"
                            Background="#FF00C88C"
                            CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}" />
                    </Border>
                </Grid>
                <ControlTemplate.Triggers>
                    <Trigger Property="IsChecked" Value="True">
                        <Trigger.EnterActions>
                            <BeginStoryboard>
                                <Storyboard>
                                    <ColorAnimation
                                        Storyboard.TargetName="bor1"
                                        Storyboard.TargetProperty="Background.Color"
                                        To="White"
                                        Duration="0:0:0.5" />
                                    <ColorAnimation
                                        Storyboard.TargetName="bor"
                                        Storyboard.TargetProperty="BorderBrush.Color"
                                        To="#FF32FAC8"
                                        Duration="0:0:0.5" />
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="dropdown" Storyboard.TargetProperty="Visibil
                                        <DiscreteObjectKeyFrame KeyTime="0:0:0.3">
                                            <DiscreteObjectKeyFrame.Value>
                                                <Visibility>Visible</Visibility>
                                            </DiscreteObjectKeyFrame.Value>
                                        </DiscreteObjectKeyFrame>
                                    </ObjectAnimationUsingKeyFrames>
                                </Storyboard>
                            </BeginStoryboard>
                        </Trigger.EnterActions>
                        <Trigger.ExitActions>
                            <BeginStoryboard>
                                <Storyboard>
                                    <ColorAnimation Storyboard.TargetName="bor1" Storyboard.TargetProperty="Background.Color" />
                                    <ColorAnimation Storyboard.TargetName="bor" Storyboard.TargetProperty="BorderBrush.Color" />
                                    <ObjectAnimationUsingKeyFrames Storyboard.TargetName="dropdown" Storyboard.TargetProperty="Visibil
                                        <DiscreteObjectKeyFrame KeyTime="0:0:0.3">
                                            <DiscreteObjectKeyFrame.Value>
                                                <Visibility>Collapsed</Visibility>
                                            </DiscreteObjectKeyFrame.Value>
                                        </DiscreteObjectKeyFrame>
                                    </ObjectAnimationUsingKeyFrames>
                                </Storyboard>
                            </BeginStoryboard>
                        </Trigger.ExitActions>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

使用自定控制元件

<Grid>
    <local:Switch Width="100" Height="100" />
</Grid>

自定義控制元件中常用的知識點

TemplatePart特性

在自定義控制元件中，有些控制元件是需要有名稱的以便於呼叫，如在重寫的OnApplyTemplate()方法中得到指定的button。這就要求使用者在使用控制元件時，不能夠修改模板中的名稱。

//應用該控制元件時呼叫
public override void OnApplyTemplate()
{
    UpButtonElement = GetTemplateChild("UpButton") as RepeatButton;
    DownButtonElement = GetTemplateChild("DownButton") as RepeatButton;
}

所以在類前面使用特性進行標註

[TemplatePart(Name = "UpButton", Type = typeof(RepeatButton))]
[TemplatePart(Name = "DownButton", Type = typeof(RepeatButton))]
public class Numeric : Control{}

視覺狀態的定義與呼叫

自定義控制元件中可以定義視覺狀態來呈現不同狀態下的效果。

在xml中定義視覺狀態，不同組下的視覺狀態是互斥的

<VisualStateManager.VisualStateGroups>
    <VisualStateGroup Name="FocusStates">
        <VisualState Name="Focused">
            <Storyboard>
                <ObjectAnimationUsingKeyFrames Storyboard.TargetName="FocusVisual" 
                           Storyboard.TargetProperty="Visibility" Duration="0">
                    <DiscreteObjectKeyFrame KeyTime="0">
                        <DiscreteObjectKeyFrame.Value>
                            <Visibility>Visible</Visibility>
                        </DiscreteObjectKeyFrame.Value>
                    </DiscreteObjectKeyFrame>
                </ObjectAnimationUsingKeyFrames>
            </Storyboard>
        </VisualState>
        <VisualState Name="Unfocused"/>
    </VisualStateGroup>
</VisualStateManager.VisualStateGroups>

在C#中對應視覺狀態的切換

private void UpdateStates(bool useTransitions)
{
    if (IsFocused)
    {
        VisualStateManager.GoToState(this, "Focused", false);
    }
    else
    {
        VisualStateManager.GoToState(this, "Unfocused", false);
    }
}

同時可以在後臺類中使用特性來標註

[TemplateVisualState(Name = "Focused", GroupName = "FocusedStates")]
[TemplateVisualState(Name = "Unfocused", GroupName = "FocusedStates")]
public class Numeric : Control{}

其實完全可以使用Trigger來實現該功能

以上就是詳解WPF中使用者控制元件和自定義控制元件的使用的詳細內容，更多關於WPF使用者控制元件自定義控制元件的資料請關注it145.com其它相關文章！

詳解WPF中使用者控制元件和自定義控制元件的使用

目錄

介紹

使用者控制元件

自定義控制元件

按鈕案例

自定義控制元件中常用的知識點

熱門文章