笔记:在WPF中OverridesDefaultStyle属性如何使用

一、目的:介绍下在WPF中OverridesDefaultStyle属性如何使用

OverridesDefaultStyle 属性在 WPF 中用于控制控件是否使用默认的主题样式。将其设置为 True 时,控件将不会应用默认的主题样式,而是完全依赖于你在 Style 中定义的样式。以下是如何使用 OverridesDefaultStyle 属性的详细说明和示例。

二、使用场景

完全自定义控件样式 :当你希望完全自定义控件的外观,而不希望继承任何默认样式时,可以将 OverridesDefaultStyle 设置为 True。

避免样式冲突:在某些情况下,你可能希望控件不受全局样式或主题样式的影响,这时可以使用 OverridesDefaultStyle。

三、示例

以下是一个示例,展示了如何使用 OverridesDefaultStyle 属性:

完全自定义按钮样式

XML 复制代码
 <Button Content="Button">
     <Button.Style>
         <Style TargetType="Button">
             <!--  Set to true to not get any properties from the themes.  -->
             <Setter Property="OverridesDefaultStyle" Value="True" />
             <Setter Property="Template">
                 <Setter.Value>
                     <ControlTemplate TargetType="Button">
                         <Grid>
                             <Ellipse Fill="{TemplateBinding Background}" />
                             <ContentPresenter HorizontalAlignment="Center"
                                               VerticalAlignment="Center" />
                         </Grid>
                     </ControlTemplate>
                 </Setter.Value>
             </Setter>
         </Style>
     </Button.Style>
 </Button>

可以看到对比效果

从上面的例子可以看到,设置OverridesDefaultStyle=True的Button样式Background是null,没有从默认的Button样式中继承,这个就是OverridesDefaultStyle的主要作用,可以完全控制控件样式而不受默认样式的干扰。

同DefaultStyleKeyProperty的区别

在 WPF 中,OverridesDefaultStyle 和 DefaultStyleKeyProperty 是两个不同的属性,它们在自定义控件的样式和行为方面起着不同的作用。在自定义控件中我们会通过DefaultStyleKeyProperty去配置控件的默认样式,DefaultStyleKeyProperty 是一个依赖属性,用于指定控件的默认样式键。通过重写 DefaultStyleKeyProperty 的元数据,你可以为自定义控件指定一个默认样式。通常在自定义控件的静态构造函数中使用 DefaultStyleKeyProperty.OverrideMetadata 方法来设置。如:

XML 复制代码
    public class CustomControl1 : Control
    {
        static CustomControl1()
        {
            DefaultStyleKeyProperty.OverrideMetadata(typeof(CustomControl1), new FrameworkPropertyMetadata(typeof(CustomControl1)));
        }
    }

在 Generic.xaml 中定义样式

XML 复制代码
<ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:local="clr-namespace:WpfCustomControlLibrary1">
    
    <Style TargetType="{x:Type local:CustomControl1}">
        <Setter Property="Template">
            <Setter.Value>
                <ControlTemplate TargetType="{x:Type local:CustomControl1}">
                    <Border Background="LightGray" BorderBrush="Black" BorderThickness="1">
                        <ContentPresenter HorizontalAlignment="Center" VerticalAlignment="Center"/>
                    </Border>
                </ControlTemplate>
            </Setter.Value>
        </Setter>
    </Style>
</ResourceDictionary>

• OverridesDefaultStyle:用于指示控件是否应忽略默认的主题样式。设置为 True 时,控件将完全依赖于你在 Style 中定义的样式。

• DefaultStyleKeyProperty:用于指定控件的默认样式键。通过重写 DefaultStyleKeyProperty 的元数据,你可以为自定义控件指定一个默认样式。

这两个属性在自定义控件的样式和行为方面起着不同的作用,通常在自定义控件的开发中会结合使用,以实现所需的样式和行为。

需要了解的知识点

FrameworkElement.OverridesDefaultStyle 属性 (System.Windows) | Microsoft Learn

FrameworkElement.DefaultStyleKeyProperty Field (System.Windows) | Microsoft Learn

System.Windows.Controls 命名空间 | Microsoft Learn

控件自定义 - WPF .NET Framework | Microsoft Learn

控件库 - WPF .NET Framework | Microsoft Learn

源码地址

GitHub - HeBianGu/WPF-ControlDemo: 示例

GitHub - HeBianGu/WPF-ControlBase: Wpf封装的自定义控件资源库

GitHub - HeBianGu/WPF-Control: WPF轻量控件和皮肤库

了解更多

System.Windows.Controls 命名空间 | Microsoft Learn

https://github.com/HeBianGu

HeBianGu的个人空间-HeBianGu个人主页-哔哩哔哩视频

相关推荐
hqwest3 小时前
C#WPF实战出真汁07--【系统设置】--菜品类型设置
开发语言·c#·wpf·grid设计·stackpanel布局
hqwest14 小时前
C#WPF实战出真汁08--【消费开单】--餐桌面板展示
c#·wpf·ui设计·wpf界面设计
orangapple14 小时前
WPF 打印报告图片大小的自适应(含完整示例与详解)
c#·wpf
三千道应用题1 天前
WPF&C#超市管理系统(6)订单详情、顾客注册、商品销售排行查询和库存提示、LiveChat报表
开发语言·c#·wpf
✎ ﹏梦醒͜ღ҉繁华落℘2 天前
开发WPF项目时遇到的问题总结
wpf
hqwest3 天前
C#WPF实战出真汁06--【系统设置】--餐桌类型设置
c#·.net·wpf·布局·分页·命令·viewmodel
Vae_Mars3 天前
WPF中使用InputBindings进行快捷键绑定
wpf
hqwest3 天前
C#WPF实战出真汁05--左侧导航
开发语言·c#·wpf·主界面·窗体设计·视图viewmodel
hqwest4 天前
C#WPF实战出真汁01--项目介绍
开发语言·c#·wpf
wuty0074 天前
WPF 实现支持动态调整高度的文本显示控件
wpf·scrollviewer·extentheight·自动高度控件·动态调整高度