这个是因为起初我在写自定义控件样式的时候 ,并不太了解 ,然后还是看着视频和查阅资料的时候才明白 ,所以写篇文章记录下

主要还是围绕着:窗口里的资源合并、窗口的 WindowChrome 设置 去进行展开的

一 、 项目结构

1
2
3
4
5
6
7
LuminaOps
├─ Font/ 字体文件(iconfont.ttf,图标就是字体里的字符)
├─ style/
│ └─ Buttons.xaml 样式定义:图标按钮长什么样
├─ Views/
│ └─ Shell.xaml 使用样式:合并进来,然后拿来套在按钮上
└─ App.xaml 全局资源(当前为空,原因见文末)

一句话:Buttons.xaml 是样式仓库,Shell.xaml 是使用方。仓库和柜台分开,是为了让所有窗口都能来取同一份样式。


然后这里是整个Buttons.xaml 代码:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">

<!-- 图标按钮样式:所有窗口共用。用法:在窗口的 Window.Resources 里合并本文件
<ResourceDictionary Source="/style/Buttons.xaml" /> -->
<Style x:Key="ButtonIconsStyle" TargetType="Button">
<Setter Property="Background" Value="Transparent" />
<Setter Property="Foreground" Value="#99A2A9" />
<Setter Property="BorderThickness" Value="0" />
<Setter Property="BorderBrush" Value="Transparent" />
<Setter Property="FontFamily" Value="/Font/#iconfont" />
<Setter Property="FontSize" Value="16" />
<Setter Property="Width" Value="32" />
<Setter Property="Height" Value="28" />
<Setter Property="Cursor" Value="Hand" />
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="Button">
<Border Background="{TemplateBinding Background}" SnapsToDevicePixels="True">
<TextBlock x:Name="IconText"
HorizontalAlignment="Center" VerticalAlignment="Center"
FontFamily="{TemplateBinding FontFamily}"
FontSize="{TemplateBinding FontSize}"
Foreground="{TemplateBinding Foreground}"
Text="{TemplateBinding Content}" />
</Border>
<ControlTemplate.Triggers>
<Trigger Property="IsMouseOver" Value="True">
<Setter TargetName="IconText" Property="Foreground" Value="#5B6670" />
</Trigger>
<Trigger Property="IsPressed" Value="True">
<Setter TargetName="IconText" Property="Foreground" Value="#2F3941" />
</Trigger>
</ControlTemplate.Triggers>
</ControlTemplate>
</Setter.Value>
</Setter>
</Style>
</ResourceDictionary>

二 、 文件的第一层:ResourceDictionary

也就是这个:

1
2
3
4
<ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
...
</ResourceDictionary>

ResourceDictionary 就是「资源字典」,可以理解成一本按名字索引的字典。

  • 每个条目有一个名字(x:Key),有一个值(样式、画刷、模板等) , 也就是 <Style x:Key=”ButtonIconsStyle” TargetType=”Button”> 这里
  • 使用时按名字去查,找不到就报错。

它有两种存在形态:

形态 写法 典型用途
内联 直接写在<Window.Resources>里 只有这个窗口用的小样式
独立文件 单独一个.xaml,根元素是ResourceDictionary 多个窗口共用的样式表

独立文件要记得在项目文件里登记成 XAML 编译项,否则不会被编译进程序:

1
2
3
4
<Page Include="style\Buttons.xaml">
<Generator>MSBuild:Compile</Generator>
<SubType>Designer</SubType>
</Page>

注意:这一步漏了,运行时会报「找不到 /style/Buttons.xaml 这个资源」,而设计器里可能一切正常,很容易误判。

使用方式也很简单 ,这种:

1
2
3
4
5
6
7
8
9
10
11
    <Button
Click="Button_Min"
Margin="0,15,14,0"
Content="&#xe62d;"
Style="{StaticResource ButtonIconsStyle}" />
<Button
Margin="0,15,15,0"
Click="Close_Click"
Content="&#xe69a;"
Style="{StaticResource ButtonIconsStyle}" />
</StackPanel>

三、Style:一组属性的打包

1
<Style x:Key="ButtonIconsStyle" TargetType="Button">

1. 三个关键词

关键字 含义 类比
x:Key 这条资源的名字,查字典用的键 文件名
TargetType 这个样式只能套给哪种控件 插头的规格
Style 「一组属性值的打包」 一个配置方案

TargetType="Button" 不只是限制,还带来两个好处:

  1. 在 Setter 里写 Property="Cursor" 时不用写成 Button.Cursor,类型已经确定。
  2. 如果 Style 不写 x:Key 只写 TargetType="Button",它会变成隐式样式——该作用域内所有 Button 自动套用,不需要写 Style=。本项目用了 x:Key,所以是显式样式,必须手动指定。

2. 为什么用样式,而不在每个按钮上写一遍

不用样式的话,两个按钮要写两遍十几行属性,改一个颜色要改两个地方,还容易漏。用样式之后:

1
<Button Style="{StaticResource ButtonIconsStyle}" Content="&#xe69a;" />

按钮这边只剩「用哪套样式」和「显示哪个图标」,视觉细节全部收拢在样式文件里。这样的话就会非常的方便了

四、Setter 逐行拆解

这让我想起了之前在写java中Spring那一套了

1
2
3
4
5
6
7
8
9
<Setter Property="Background" Value="Transparent" />
<Setter Property="Foreground" Value="#99A2A9" />
<Setter Property="BorderThickness" Value="0" />
<Setter Property="BorderBrush" Value="Transparent" />
<Setter Property="FontFamily" Value="/Font/#iconfont" />
<Setter Property="FontSize" Value="16" />
<Setter Property="Width" Value="32" />
<Setter Property="Height" Value="28" />
<Setter Property="Cursor" Value="Hand" />

Setter 的格式固定为「属性 = 值」,一条一行。逐条说明:

属性 值 作用 去掉会怎样
Background Transparent 背景透明 按钮会显示默认的浅灰色底块
Foreground #99A2A9 文字(图标)颜色,浅灰 变成默认的近黑色,视觉过重
BorderThickness 0 边框粗细为 0,即不要边框 默认模板会画出边框
BorderBrush Transparent 边框画刷透明 当前看不出来,是防御性写法
FontFamily /Font/#iconfont 用哪个字体渲染文字 图标变成方框或被回退字体替代
FontSize 16 图标字号,实际就是图标大小 图标偏小
Width/Height 32/28 按钮固定的点击区域 按钮size随内容变,两个按钮不对齐
Cursor Hand 鼠标移到按钮上变成手型 光标保持箭头,用户不确定能不能点

1. Cursor=”Hand” 是什么

Cursor 是控件的一个属性,控制鼠标指针悬停其上时显示成什么形状。常见取值:

现在才明白 ,这原来是箭头样式

值 光标样子 使用场景
Arrow 默认箭头 普通区域
Hand 手型(食指指着的形状) 按钮、链接,暗示「这里可以点」
IBeam 竖线 I 形 文本输入框
Wait 沙漏或转圈 正在处理中
SizeWE/SizeNS 左右、上下双向箭头 可拖拽的边框、分隔条

它不影响功能,只影响手感。一行代码的成本,换来「这个图标能点」的心理暗示,所以加了。系统按钮(最小化、关闭)本身没有手型光标,但自定义界面里加一点提示更友好——这属于设计选择,去掉也不会坏。

2. BorderThickness 和 BorderBrush 为什么都写

这两个是配套的:

  • BorderThickness 决定边框有多粗(0 表示没有边框,占 0 宽度)。
  • BorderBrush 决定边框用什么颜色画。

逻辑上,厚度是 0 时画刷无关紧要。但这里仍然写 Transparent 是一个防御性习惯:将来如果把某处厚度改成 1,没有显式指定画刷的话,会冒出默认的黑色或系统色边框,看起来像突然多了一条线。提前把画刷定成透明,就把这种意外挡掉了。

另外一提:Background="Transparent" 和 Background 不写是两回事。

  • 不写:控件没有背景,鼠标点不到空白处(命中测试会穿透)。
  • 写 Transparent:有一层完全透明的背景,鼠标能点中,只是看不见。

对这个按钮来说,我们需要它能被点中,所以必须是 Transparent 而不是留空。这也是初学者最常踩的一个隐形坑。

3. FontFamily 里的 # 是什么

1
<Setter Property="FontFamily" Value="/Font/#iconfont" />

格式是 字体文件路径#字体族名:

  • /Font/ 是字体文件所在目录
  • #iconfont 是字体文件内部的族名(Family Name)

少写 #iconfont,WPF 会把整串 /Font/iconfont 当成一个「名字叫这串的字体」去找,找不到就静默回退到系统默认字体,不报错。而图标用的字符在 Unicode 私有区(PUA),默认字体里没有对应字形,于是渲染成空心方框。

五、ControlTemplate:决定按钮「长什么样」

1
2
3
4
5
6
7
<Setter Property="Template">
<Setter.Value>
<ControlTemplate TargetType="Button">
...
</ControlTemplate>
</Setter.Value>
</Setter>

这里是整份样式最关键的部分。

image

1. 为什么需要模板

WPF 的控件是「行为」和「外观」分离的:

  • Button 类只负责行为:能点击、有 IsPressed 状态、会触发 Click。
  • 它长什么样,由 Template 属性里的一套 XAML 决定。

不写模板,Button 会用系统默认模板:一个带渐变、圆角、边框、按下会凹陷的经典按钮。你只改 Background、BorderThickness 这些属性,会发现效果有限——因为默认模板的内部结构是固定的。

写上自己的 ControlTemplate,等于换掉整个外观,从此按钮里面画什么完全由你决定。

2. Border 的作用

1
<Border Background="{TemplateBinding Background}" SnapsToDevicePixels="True">

Border 是「带背景和边框的矩形容器」,这里是按钮的底层:

  • 它铺满整个按钮,提供可点击的背景区域。
  • Background 通过 TemplateBinding 接到 Button.Background,所以样式里那句 Transparent 最终作用在这一层上。
  • 里面可以放任意内容,这里放的是图标文字。

用 Border 而不是 Grid 或 Rectangle,是因为它天生支持背景、边框、内边距(Padding)和圆角(CornerRadius),以后想加圆角只需加一个 CornerRadius="6"。

3. 为什么要用 TextBlock,不能直接显示 Content

1
2
3
4
5
6
<TextBlock x:Name="IconText"
HorizontalAlignment="Center" VerticalAlignment="Center"
FontFamily="{TemplateBinding FontFamily}"
FontSize="{TemplateBinding FontSize}"
Foreground="{TemplateBinding Foreground}"
Text="{TemplateBinding Content}" />

先说结论:因为按钮里显示的内容本质上是一段文字(图标字体里的一个字符),而 TextBlock 是最直接、最可控的文字载体。

展开讲:

Button.Content 的类型是 object,可以塞字符串、图片、甚至整块面板。默认模板用 ContentPresenter 来显示它,ContentPresenter 内部会自动判断内容类型再决定怎么渲染。

这里换成 TextBlock,是主动做了一次简化——假设「内容永远是一段文字」。好处是:

  1. 能精确控制文字渲染。FontFamily、FontSize、Foreground 直接绑到 TextBlock 上,图标字体、颜色、大小完全在掌控中。
  2. 结构简单,一层就够。没有 ContentPresenter 那层间接,调试时一眼看到底。
  3. Text="{TemplateBinding Content}" 会自动转换。Content 是 object,Text 是 string,WPF 会调用内容的 ToString(),所以 Content="&#xe69a;" 的字符能正确显示。

代价是:这个按钮只能显示文字。如果哪天想让它显示一张图片或图文混排,就得改回 ContentPresenter。当前需求只是图标,用 TextBlock 是最合适的取舍。

提示:HorizontalAlignment / VerticalAlignment 设成 Center,让字符在按钮里居中。图标字体常带有不均衡的字形上下留白,肉眼看起来才正。

4. TemplateBinding 是什么

1
FontFamily="{TemplateBinding FontFamily}"

TemplateBinding 的意思是: 「把模板所属控件(这里是 Button)的这个属性的值,拿过来用」 。

它可以理解成一条单向的数据管道,方向固定为「控件 → 模板内部元素」。所以:

  • 样式里写的 FontSize="16" 会先变成 Button.FontSize,再流到 TextBlock.FontSize。
  • 好处是:将来某个按钮想单独放大,只要在按钮上写 FontSize="20",模板内部自动跟着变,不用改样式。

它等价于更啰嗦的写法:

1
FontFamily="{Binding FontFamily, RelativeSource={RelativeSource TemplatedParent}}"

记住 TemplateBinding 是它的简写即可。注意它只能单向(控件 → 模板内的元素),如果要在模板内部把值回传给控件,得用 Binding。

5. SnapsToDevicePixels=”True” 是什么

1
<Border ... SnapsToDevicePixels="True">

字面意思是「对齐到设备像素」。要理解它,先要知道 WPF 的坐标系是逻辑像素,可以是小数。

举一个会出问题的例子:某个元素的宽度算出来是 32.4 个逻辑像素,边框粗细 0.75,位置又落在 10.3 这种坐标上。WPF 要做抗锯齿,就会把这些「半个像素」用半透明的方式混合绘制,结果边缘看起来发虚、发毛,字体也可能糊。

SnapsToDevicePixels="True" 的作用就是:绘制这个元素时,把边缘吸附到真实的物理像素格子上,不做半像素混合,线条和文字因此清晰锐利。

什么时候需要它:

场景 是否需要
细边框、1px 分割线、图标、小字号文字 需要,否则容易糊
大块纯色区域 影响不大
正在做缩放动画 可能反而有轻微抖动

补充两个相关设置,遇到模糊时可以一起考虑:

  • UseLayoutRounding="True":在布局阶段就把位置和尺寸取整,比 SnapsToDevicePixels 更彻底,通常直接加在 Window 或根容器上。
  • RenderOptions.EdgeMode="Aliased":强制关掉抗锯齿,线条最锐利,但斜线和圆角会出锯齿。

本项目只在小图标按钮上加了 SnapsToDevicePixels,属于「花一个属性,换清晰边缘」的低成本优化。

六、ControlTemplate.Triggers:让按钮会「变」

1
2
3
4
5
6
7
8
<ControlTemplate.Triggers>
<Trigger Property="IsMouseOver" Value="True">
<Setter TargetName="IconText" Property="Foreground" Value="#5B6670" />
</Trigger>
<Trigger Property="IsPressed" Value="True">
<Setter TargetName="IconText" Property="Foreground" Value="#2F3941" />
</Trigger>
</ControlTemplate.Triggers>

1. Trigger 的本质

Trigger 是一个条件:某个属性等于某个值时,就执行里面的 Setter。

触发器 条件 效果
第一个 鼠标悬停在按钮上(IsMouseOver = True) 图标颜色变成#5B6670(深一档)
第二个 鼠标左键按下(IsPressed = True) 图标颜色变成#2F3941(更深)

条件不成立时,Setter 自动撤销,颜色回到样式里定的 #99A2A9。这是自动回滚的,不需要写「鼠标移出时改回来」的代码。

IsMouseOver、IsPressed、IsEnabled、IsFocused 这些是控件内置的状态属性,WPF 会自动维护,你只管判断。

2. TargetName=”IconText” 是什么

Setter 有两种作用对象:

写法 作用对象
<Setter Property="X" .../> 模板所属的控件本身(Button)
<Setter TargetName="IconText" Property="X" .../> 模板里名为IconText的那个元素

因为颜色是画在 TextBlock 上的(Foreground),所以这里必须指定 TargetName="IconText",指向第五节里给它起的名字:

1
<TextBlock x:Name="IconText" ... />

这行 x:Name 存在的唯一目的,就是让触发器能叫得应。名字漏写或写错,运行时会报「找不到名为 IconText 的元素」。

另一种写法是让 Setter 不指定 TargetName,直接改 Button.Foreground,靠 WPF 的属性继承传下去给 TextBlock。两种都能跑,但 TargetName 更明确——它告诉你颜色到底改在哪一层,排查时少绕一圈。

3. 为什么写在 ControlTemplate.Triggers 而不是 Style.Triggers

因为这两个兄弟能碰的东西不一样:

位置 能改什么
Style.Triggers 只能改控件自身的属性(Button.Foreground等)
ControlTemplate.Triggers 除了控件自身属性,还能用TargetName改模板内部元素

要在悬停时精确修改模板里的 TextBlock,就必须写在 ControlTemplate.Triggers 里。

4. 三个颜色是一组「深浅关系」

1
2
3
常态   #99A2A9   浅灰
悬停 #5B6670 中灰
按下 #2F3941 深灰

同一色相、逐级加深,用户能感到「按下去更有实感」。如果三个颜色毫无关系(比如灰、红、蓝),会让人以为按钮状态出了问题。

七、使用方之一:Window.Resources 里的合并

1
2
3
4
5
6
7
<Window.Resources>
<ResourceDictionary>
<ResourceDictionary.MergedDictionaries>
<ResourceDictionary Source="/style/Buttons.xaml" />
</ResourceDictionary.MergedDictionaries>
</ResourceDictionary>
</Window.Resources>

1. 三层嵌套分别是什么

看起来啰嗦,其实是三个不同的东西:

层级 是什么 比喻
Window.Resources 这个窗口的资源仓库 我的书桌抽屉
ResourceDictionary 仓库里的「一本字典」 抽屉里的一个文件夹
MergedDictionaries 这本字典又「借」了哪些外部字典 文件夹里夹着的别人整理的资料

MergedDictionaries 是 ResourceDictionary 的一个集合属性,可以放多个外部字典:

1
2
3
4
<ResourceDictionary.MergedDictionaries>
<ResourceDictionary Source="/style/Buttons.xaml" />
<ResourceDictionary Source="/style/Colors.xaml" />
</ResourceDictionary.MergedDictionaries>

多个字典里如果出现同名键,后合并的会覆盖先合并的(同层作用域内,后面写的有更高优先级)。

2. 为什么不能直接在 Window 里放 Style

当然可以,早前的版本就是直接写 <Window.Resources><Style .../></Window.Resources>。能跑,但有两个问题:

  1. 复制粘贴。第二个窗口要用同样的按钮,得再把十几行样式贴一遍。
  2. 改一处漏一处。调整颜色时容易只改了一个窗口。

合并外部字典之后,样式只有一份,谁用谁引。

3. Source 的路径怎么写

1
<ResourceDictionary Source="/style/Buttons.xaml" />
  • 开头的 / 表示从程序集根目录开始找,与你当前 xaml 文件在哪一层无关。
  • 这里的 Buttons.xaml 是被编译成 XAML 资源的(Page 项),所以运行时能按这个路径解析到。
  • 忘记在 .csproj 里登记成 Page,就等于文件存在但没有编译进程序,运行时找不到。

4. 作用域:合并到哪一层,就管哪一层

合并位置 谁可以用
Application.Resources(App.xaml) 所有窗口、所有控件
Window.Resources 这个窗口及其所有子元素
某个StackPanel.Resources 只有这个面板内部

优先放「最小的够用作用域」,避免全局污染;确定要全项目共用,再往上提到 App 层。

{StaticResource ButtonIconsStyle} 查找时也是按这个链条往外找:控件自身 → 父级 → 窗口 → 应用 → 系统主题,都找不到就抛异常。

八、使用方之二:WindowChrome 设置

1
2
3
<WindowChrome.WindowChrome>
<WindowChrome CaptionHeight="60"/>
</WindowChrome.WindowChrome>

这两行的作用是:接管窗口的外壳(标题栏、边框),换成自己画的内容。

  • 不写它,窗口由系统绘制,标题栏上自带最小化、最大化、关闭按钮,你没法在里面放自己的控件。
  • 写了它,那圈外壳消失,你可以自由排版;但系统相关的行为(拖动窗口、双击最大化、右键系统菜单、边缘改大小)要靠 WindowChrome 的属性来约定。

CaptionHeight="60" 就是这份约定里最关键的一项:从窗口顶部往下 60 像素算标题栏区域,这个区域内按住空白可以拖窗口、双击可以最大化、右键会弹出系统菜单。

因此有一个必然的副作用:落在这 60 像素里的控件点不动,因为鼠标操作被系统当成拖动窗口了。解决办法是给需要交互的控件加上:

1
WindowChrome.IsHitTestVisibleInChrome="True"

详细原理见同目录笔记《WindowChrome.IsHitTestVisibleInChrome 详解》。

九、整份样式的结构总览

1
2
3
4
5
6
7
8
9
ResourceDictionary                    一本资源字典
└─ Style x:Key="ButtonIconsStyle" 一条名为 ButtonIconsStyle 的样式
├─ TargetType="Button" 只能套给按钮
├─ Setter × 9 基础属性:背景、颜色、字体、尺寸、光标
└─ Setter Property="Template"
└─ ControlTemplate 按钮长什么样
├─ Border 底层:背景块
│ └─ TextBlock IconText 图标本体(用图标字体渲染字符)
└─ Triggers × 2 悬停 / 按下时改颜色

读 XAML 时按这个树形往下看,每一层负责一件事,就不会被缩进搞晕。

十、常见疑问速查

疑问 答案
为什么按钮能用图标字符? 图标被做成了字体文件,字符就是图标,改Content换图标
为什么Content是字符串却用TextBlock显示? TemplateBinding会自动ToString();代价是只能显示文字
为什么颜色改在TextBlock上而不是Button上? 颜色最终画在文字上,TargetName直接指定最准
为什么按钮不写Background也要写Transparent? 不写则没有背景区域,鼠标点不中空白处
样式改了但界面没变? 检查样式文件是否登记为Page、合并路径是否写对、有没有被同名键覆盖
改完样式要重启程序吗? 要,XAML 资源在启动时加载

十一、术语小抄

术语 含义
ResourceDictionary 资源字典,按x:Key索引的资源集合
Style 一组属性值的打包,可复用
TargetType 样式适用的控件类型
Setter 给某个属性赋值的一条指令
ControlTemplate 控件的视觉结构定义,决定外观
TemplateBinding 模板内部元素读取「所属控件」属性的单向绑定
Trigger 属性满足条件时执行 Setter,条件消失自动回滚
TargetName 指定触发器的 Setter 作用于模板内的哪个元素
MergedDictionaries 把外部字典合并进来的集合
SnapsToDevicePixels 绘制时边缘吸附物理像素,减少模糊
Cursor 鼠标悬停时指针形状
CaptionHeight WindowChrome 判定的标题栏高度