通过

WindowChrome 类

表示描述窗口的非客户端区域的自定义项的对象。

继承层次结构

System.Object
  System.Windows.Threading.DispatcherObject
    System.Windows.DependencyObject
      System.Windows.Freezable
        Microsoft.Windows.Shell.WindowChrome

命名空间：  Microsoft.Windows.Shell
程序集：  Microsoft.Windows.Shell（在 Microsoft.Windows.Shell.dll 中）

语法

声明
Public Class WindowChrome _
    Inherits Freezable

public class WindowChrome : Freezable

public ref class WindowChrome : public Freezable

type WindowChrome =  
    class
        inherit Freezable
    end

public class WindowChrome extends Freezable

WindowChrome 类型公开以下成员。

构造函数

  名称 说明
公共方法 WindowChrome 初始化 WindowChrome 类的新实例。

页首

属性

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

页首

附加属性

  名称 说明
公共附加属性 IsHitTestVisibleInChrome 获取或设置一个值，该值表示 WPF 命中测试在窗口非工作区中的元素是否可用。
公共附加属性 ResizeGripDirection 获取或设置一个值，该值表示输入元素的大小调整手柄行为的方向。
公共附加属性 WindowChrome 获取或设置附加到窗口的 WindowChrome 的实例。

页首

方法

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

页首

事件

  名称 说明
公共事件 Changed 在修改 Freezable 或其包含的对象时发生。 （继承自 Freezable。）

页首

字段

  名称 说明
公共字段静态成员 CaptionHeightProperty 标识 CaptionHeight 依赖项属性。
公共字段静态成员 CornerRadiusProperty 标识 CornerRadius 依赖项属性。
公共字段静态成员 GlassFrameThicknessProperty 标识 GlassFrameThickness 依赖项属性。
公共字段静态成员 IsHitTestVisibleInChromeProperty 标识 IsHitTestVisibleInChrome 依赖项属性。
公共字段静态成员 NonClientFrameEdgesProperty 标识 NonClientFrameEdges 依赖项属性。
公共字段静态成员 ResizeBorderThicknessProperty 标识 ResizeBorderThickness 依赖项属性。
公共字段静态成员 ResizeGripDirectionProperty 标识 ResizeGripDirection 依赖项属性。
公共字段静态成员 UseAeroCaptionButtonsProperty 标识 UseAeroCaptionButtons 依赖项属性。
公共字段静态成员 WindowChromeProperty 标识 WindowChrome 依赖项属性。

页首

备注

WindowChrome 类使您能够扩展 Windows 演示文稿基础 (WPF) 内容到非客户端窗口的区域，通常仅适用于操作系统的窗口管理器。

标准 Windows

标准 windows 由两个重叠的矩形组成。 外部矩形是“非工作区”，通常称为“镶边” 。 它由操作系统的窗口管理器进行绘制和管理。 其维度由标准的操作系统设置决定。 非客户端框架提供了标准窗口功能和行为。 这些包括标题按钮（最小化、最大化和关闭）、窗口边框、大小调整与移动行为、应用程序图标与标题以及系统菜单。 内部矩形是 “工作区”。 它包含应用程序的内容，并由应用程序进行绘制和管理。 关于 WPF 应用程序中窗口的更多信息，请参见 WPF Windows 概述。

以下显示了标准窗口的各个部件。

窗口元素

自定义 Windows

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

WindowStyle.None

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

WindowChrome

要自定义窗口，同时保留其标准功能，您可以使用 WindowChrome 类。 WindowChrome 类从视觉上将窗口框架的功能分开，并允许您控制应用程序窗口的工作区和非工作区的边界。 WindowChrome 类允许您将 WPF 内容放置在窗口框架中，通过扩展工作区至非工作区来实现。 同时，它将通过两个不可见区域保留系统行为；调整边框大小 和标题 区域。

有两个主要部分可创建使用 WindowChrome 类的自定义窗口。 首先，通过设置属性上公开 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 毛玻璃效果是否可用。 如果玻璃效果不可用，则应通过把窗口样式设置为 null 来提供备用的窗口样式，样式不使用玻璃框架或标准窗口。

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

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

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

以下 XAML 标记显示应用 WindowChrome 类对窗口进行自定义所需的主要元素。

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

第一个 setter 将 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 添加了图像和 textblock 来显示图标和标题。 这两个元素都绑定到窗口上的相应属性。 图像宽度与 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"/>

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.Windows.Shell 命名空间