WindowChrome 类

定义

命名空间:

System.Windows.Shell

程序集:

PresentationFramework.dll

表示一个对象，它描述窗口非工作区区域的自定义。

public ref class WindowChrome : System::Windows::Freezable

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

继承

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

注解

类WindowChrome使你能够将Windows Presentation Foundation (WPF) 内容扩展到通常为操作系统的窗口管理器保留的窗口的非工作区。

标准 Windows

标准窗口由两个重叠的矩形组成。 外部矩形是 非工作区，通常称为 镶边。 它由操作系统的窗口管理器绘制和管理。 其尺寸由标准操作系统设置决定。 非客户端帧提供标准窗口功能和行为。 其中包括描述文字按钮 (最小化、最大化和关闭) 、窗口边框、调整大小和移动行为、应用程序图标和标题以及系统菜单。 内部矩形是 工作区。 它包含应用程序的内容，并由应用程序进行绘制和管理。 有关 WPF 应用程序中的窗口的详细信息，请参阅 WPF Windows 概述。

下图显示了标准窗口的各个部分。

自定义 Windows

可以通过将 属性设置为 Window.WindowStyleNone 或使用 WindowChrome 类来自定义窗口边框。

WindowStyle.None

自定义 WPF 应用程序窗口外观的一种方法是将 Window.WindowStyle 属性设置为 None。 这会从窗口中删除非客户端框架，并仅保留可向其应用自定义样式的工作区。 但是，删除非客户端帧时，也会丢失它提供的系统功能和行为，例如描述文字按钮和窗口大小调整。 另一个副作用是窗口在最大化时会覆盖 Windows 任务栏。 设置 WindowStyle.None 使你能够创建完全自定义的应用程序，但还要求在应用程序中实现自定义逻辑以模拟标准窗口行为。

WindowChrome

若要自定义窗口，同时保留其标准功能，可以使用 WindowChrome 类。 类 WindowChrome 将窗口框架的功能与视觉对象分开，并允许你控制应用程序窗口的客户端和非客户端区域之间的边界。 类 WindowChrome 允许通过扩展工作区以覆盖非工作区，将 WPF 内容放入窗口框架中。 同时，它通过两个不可见区域保留系统行为：调整边框大小和描述文字区域。

使用 WindowChrome 类创建自定义窗口有两个main部分。 首先，通过设置对象上 WindowChrome 公开的属性来自定义窗口的非客户端部分。 然后，为窗口提供一个模板，用于定义扩展到非工作区的应用程序部分。 对象上 WindowChrome 公开的属性为 ResizeBorderThickness、 CaptionHeight、 CornerRadius和 GlassFrameThickness。

属性 ResizeBorderThickness 指定应用程序窗口外部周围的不可见边框，用户可以单击并拖动该边框来调整窗口大小。

属性 CaptionHeight 指定窗口顶部的不可见区域，该区域启用通常与标题栏关联的系统行为。 这些行为包括：单击并拖动以移动窗口，双击以最大化窗口，右键单击以显示系统菜单。

调整边框大小和描述文字区域没有任何视觉元素;它们仅定义响应输入的区域并启用系统提供的标准窗口行为。

属性 CornerRadius 指定窗口角的圆角的圆角量。 如果为窗口启用了玻璃框架，则此属性没有任何效果。

属性 GlassFrameThickness 指定窗口周围的玻璃框架的宽度。 默认情况下，它使用 属性指定的 WindowNonClientFrameThickness 系统值来模拟标准窗口的外观。 使用玻璃框架时，“最小化”、“最大化”和“关闭”描述文字按钮是可见和交互式的。 应用程序负责显示应用程序图标并描述文字文本。 可以设置 GlassFrameThickness 属性，使玻璃框架比默认值更宽或更窄。

注意

更改属性时GlassFrameThickness，描述文字按钮的大小不会更改。 如果玻璃框架顶部的高度小于描述文字按钮的高度，则描述文字按钮将不完全可见。

若要创建没有玻璃框架的自定义窗口，请将 GlassFrameThickness 属性设置为 0 的统一值。 这将禁用和隐藏标准描述文字按钮。

若要扩展玻璃框架以覆盖整个窗口，请在 GlassFrameThickness 任意一侧将 属性设置为负值。 当 属性 GlassFrameThickness 设置为任何端的负值时，其强制值将等于 GlassFrameCompleteThickness。

注意

Aero 是 Windows Vista 中引入的一组对 Windows 桌面的外观和功能的视觉增强。 Aero 最明显的功能之一是半透明玻璃窗边框。 Windows Aero 由桌面窗口管理器的桌面组合功能 (DWM) 启用。

并非所有操作系统都支持 Windows Aero 玻璃效果，可以在支持的操作系统上禁用。 如果 Windows Aero 不可用，则无论属性值如何 GlassFrameThickness ，都不会显示玻璃框架。 此属性指定的边框区域将改为显示为黑色。 IsGlassEnabled 检查 属性以验证 Windows Aero 玻璃效果是否可用。 如果玻璃效果不可用，应提供不使用玻璃框架的备用窗口样式，或者通过将窗口样式设置为 null 来使用标准窗口。

通过指定用于定义框架内容的外观和行为的 ControlTemplate，将 WPF 内容扩展到窗口框架中。 将 ControlTemplate 的 TargetType 设置为要自定义的窗口的类型。

<ControlTemplate TargetType="{x:Type local:MainWindow}">

默认情况下，窗口非工作区内的任何视觉元素部分都不是交互式的。 若要在非工作区中启用交互式元素，请将 WindowsChrome.IsHitTestVisibleInChrome attached 属性附加到元素，并将其设置为 true。

以下 XAML 标记显示了使用 WindowChrome 类自定义窗口所需的main元素。

<Style x:Key="StandardStyle" TargetType="{x:Type local:MainWindow}">
    <Setter Property="shell:WindowChrome.WindowChrome">
        <Setter.Value>
            <shell:WindowChrome />
        </Setter.Value>
    </Setter>
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type local:MainWindow}">
                <Grid>
                    <Border Background="White"
                            Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
                        <ContentPresenter Content="{TemplateBinding Content}" />
                    </Border>
                    <TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
                               VerticalAlignment="Top" HorizontalAlignment="Left"
                               Margin="36,8,0,0"/>
                    <Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
                           VerticalAlignment="Top" HorizontalAlignment="Left"
                           Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
                           Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
                           shell:WindowChrome.IsHitTestVisibleInChrome="True"/>
                </Grid>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

第一个资源库将 WindowChrome 附加到窗口。 它使用 WindowChrome 属性的所有默认值，这使得窗口看起来像一个标准窗口。

<Setter Property="shell:WindowChrome.WindowChrome">
    <Setter.Value>
        <shell:WindowChrome />
    </Setter.Value>
</Setter>

窗口模板必须指定内容演示者，以显示应用程序中指定窗口的内容。 默认情况下，WindowChrome 类扩展工作区以覆盖非客户端边框。 若要揭开玻璃框架，需要指定 ContentPresenter 周围的边距。 此标记指定内容演示者周围带有白色背景的边框，以模拟标准窗口的外观。 它还指定绑定到 WindowNonClientFrameThickness 属性的边距，该属性获取框架的默认系统宽度。

<Border Background="White"
    Margin="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=WindowNonClientFrameThickness}">
    <ContentPresenter Content="{TemplateBinding Content}" />
</Border>

WindowChrome 类不显示应用程序图标和标题;它们必须作为自定义内容添加到边框。 以下 XAML 添加图像和文本块以显示图标和标题。 这两个元素都绑定到窗口上的相应属性。 图像宽度绑定到 SmallIconSize 宽度，这将获取图标的默认系统大小。 IsHitTestVisibleInChrome 附加属性在图像上设置，以便它可以接收鼠标事件。

<Image Source="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Icon}"
       VerticalAlignment="Top" HorizontalAlignment="Left"
       Margin="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=(shell:WindowChrome.WindowChrome).ResizeBorderThickness}"
       Width="{Binding Source={x:Static shell:SystemParameters2.Current}, Path=SmallIconSize.Width}"
       shell:WindowChrome.IsHitTestVisibleInChrome="True"/>

<TextBlock Text="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Title}"
           VerticalAlignment="Top" HorizontalAlignment="Left"
           Margin="36,8,0,0"/>

构造函数

WindowChrome()

初始化 WindowChrome 类的新实例。

字段

CaptionHeightProperty	标识 CaptionHeight 依赖项属性。
CornerRadiusProperty	标识 CornerRadius 依赖项属性。
GlassFrameThicknessProperty	标识 GlassFrameThickness 依赖项属性。
IsHitTestVisibleInChromeProperty	标识 IsHitTestVisibleInChrome 依赖项属性。
NonClientFrameEdgesProperty	标识 NonClientFrameEdges 依赖项属性。
ResizeBorderThicknessProperty	标识 ResizeBorderThickness 依赖项属性。
ResizeGripDirectionProperty	标识 ResizeGripDirection 依赖项属性。
UseAeroCaptionButtonsProperty	标识 UseAeroCaptionButtons 依赖项属性。
WindowChromeProperty	标识 WindowChrome 依赖项属性。

属性

CanFreeze	获取一个值，该值指示是否可将对象变为不可修改。 (继承自 Freezable)
CaptionHeight	获取或设置窗口顶部标题区域的高度。
CornerRadius	获取或设置一个值，该值表示圆形窗口边角的度数。
DependencyObjectType	DependencyObjectType获取包装此实例的 CLR 类型的 。 (继承自 DependencyObject)
Dispatcher	获取与此 Dispatcher 关联的 DispatcherObject。 (继承自 DispatcherObject)
GlassFrameCompleteThickness	获取统一的粗细为 -1。
GlassFrameThickness	获取或设置一个值，该值表示窗口周围透明边框的宽度。
IsFrozen	获取一个值，该值指示对象当前是否可修改。 (继承自 Freezable)
IsSealed	获取一个值，该值指示此实例当前是否为密封的（只读）。 (继承自 DependencyObject)
NonClientFrameEdges	获取或设置一个值，该值表示窗口框架边缘是否归客户端所有。
ResizeBorderThickness	获取或设置一个值，该值表示边框的宽度，用于调整窗口大小尺寸。
UseAeroCaptionButtons	获取或设置一个值，表示是对 Windows Aero 标题按钮启用的命中测试是否可用。

附加属性

IsHitTestVisibleInChrome	表示一个对象，它描述窗口非工作区区域的自定义。
ResizeGripDirection	表示一个对象，它描述窗口非工作区区域的自定义。
WindowChrome	获取或设置附加到窗口的 WindowChrome 的实例。

方法

CheckAccess()	确定调用线程是否可以访问此 DispatcherObject。 (继承自 DispatcherObject)
ClearValue(DependencyProperty)	清除属性的本地值。 要清除的属性由 DependencyProperty 标识符指定。 (继承自 DependencyObject)
ClearValue(DependencyPropertyKey)	清除只读属性的本地值。 要清除的属性由 DependencyPropertyKey 指定。 (继承自 DependencyObject)
Clone()	创建 Freezable 的可修改克隆，以制作该对象值的深层副本。 在复制此对象的依赖属性时，此方法会复制表达式（可能不再解析），但不复制动画或其当前值。 (继承自 Freezable)
CloneCore(Freezable)	使用基（未经过动画处理的）属性值使该实例成为指定 Freezable 的克隆（深层复制）。 (继承自 Freezable)
CloneCurrentValue()	使用 Freezable 的当前值创建其可修改复本（深层副本）。 (继承自 Freezable)
CloneCurrentValueCore(Freezable)	使用当前属性值使该实例成为指定 Freezable 的可修改克隆（深层复制）。 (继承自 Freezable)
CoerceValue(DependencyProperty)	对指定依赖属性的值进行强制。 通过对调用方 DependencyObject 上存在的依赖属性的属性元数据中所指定的任何 CoerceValueCallback 函数进行调用来完成此操作。 (继承自 DependencyObject)
CreateInstance()	初始化 Freezable 类的新实例。 (继承自 Freezable)
CreateInstanceCore()	创建 WindowChrome 类的新实例。
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
Freeze()	使当前对象不可修改，并且将其 IsFrozen 属性设置为 true。 (继承自 Freezable)
FreezeCore(Boolean)	使 Freezable 对象变为不可修改或测试是否可将其变为不可修改。 (继承自 Freezable)
GetAsFrozen()	使用基（未经过动画处理的）属性值创建 Freezable 的冻结副本。 由于副本已冻结，因此将通过引用复制任何冻结的子对象。 (继承自 Freezable)
GetAsFrozenCore(Freezable)	让该实例成为指定的 Freezable 的冻结克隆，前者使用基（非动画的）属性值。 (继承自 Freezable)
GetCurrentValueAsFrozen()	使用当前属性值创建 Freezable 的冻结副本。 由于副本已冻结，因此将通过引用复制任何冻结的子对象。 (继承自 Freezable)
GetCurrentValueAsFrozenCore(Freezable)	使当前实例成为指定 Freezable 的冻结克隆。 如果对象具有动画依赖属性，则复制其当前的动画值。 (继承自 Freezable)
GetHashCode()	获取此 DependencyObject 的哈希代码。 (继承自 DependencyObject)
GetIsHitTestVisibleInChrome(IInputElement)	从指定的输入元素获取 IsHitTestVisibleInChrome 附加属性的值。
GetLocalValueEnumerator()	创建一个专用的枚举数，用于确定哪些依赖项属性在此 DependencyObject 上具有以本地方式设置的值。 (继承自 DependencyObject)
GetResizeGripDirection(IInputElement)	从指定的输入元素获取 ResizeGripDirection 附加属性的值。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetValue(DependencyProperty)	对 DependencyObject 的此实例返回依赖属性的当前有效值。 (继承自 DependencyObject)
GetWindowChrome(Window)	从指定的 WindowChrome 中获取 Window 附加属性的值。
InvalidateProperty(DependencyProperty)	重新评估指定依赖属性的有效值。 (继承自 DependencyObject)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnChanged()	修改当前 Freezable 对象时调用。 (继承自 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	确保为刚刚设置的 DependencyObjectType 数据成员建立适当的上下文指针。 (继承自 Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	此成员支持Windows Presentation Foundation (WPF) 基础结构，不应直接从代码使用。 (继承自 Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	重写 OnPropertyChanged(DependencyPropertyChangedEventArgs) 的 DependencyObject 实现，以同时调用任何响应类型 Freezable 不断变化的依赖属性的 Changed 处理程序。 (继承自 Freezable)
ReadLocalValue(DependencyProperty)	如果存在，则返回依赖属性的本地值。 (继承自 DependencyObject)
ReadPreamble()	确保正在从有效的线程访问 Freezable。 Freezable 的继承者必须在任何 API 一开始读取不属于依赖项对象的数据成员时调用此方法。 (继承自 Freezable)
SetCurrentValue(DependencyProperty, Object)	设置依赖属性的值而不更改其值源。 (继承自 DependencyObject)
SetIsHitTestVisibleInChrome(IInputElement, Boolean)	设置指定输入元素上的 IsHitTestVisibleInChrome 附加属性的值。
SetResizeGripDirection(IInputElement, ResizeGripDirection)	设置指定输入元素上的 ResizeGripDirection 附加属性的值。
SetValue(DependencyProperty, Object)	设置依赖属性的本地值，该值由其依赖属性标识符指定。 (继承自 DependencyObject)
SetValue(DependencyPropertyKey, Object)	设置一个只读依赖属性的本地值，该值由依赖属性的 DependencyPropertyKey 标识符指定。 (继承自 DependencyObject)
SetWindowChrome(Window, WindowChrome)	设置指定的 WindowChrome 的 Window 附加属性的值。
ShouldSerializeProperty(DependencyProperty)	返回一个值，该值指示序列化进程是否应序列化所提供的依赖属性的值。 (继承自 DependencyObject)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
VerifyAccess()	强制调用线程具有此 DispatcherObject 的访问权限。 (继承自 DispatcherObject)
WritePostscript()	引发 Freezable 的 Changed 事件并调用其 OnChanged() 方法。 从 Freezable 派生的类应在修改的类成员不存储为依赖属性的任何 API 的末尾调用此方法。 (继承自 Freezable)
WritePreamble()	验证 Freezable 是否未被冻结，并且是否正在从有效的线程上下文中访问它。 Freezable 的继承项应当在任何 API 一开始写入不属于依赖项属性的数据成员时调用此方法。 (继承自 Freezable)

事件

Changed

在修改 Freezable 或其包含的对象时发生。 (继承自 Freezable)