syncfusion-wpf-chromeless-window

实现 ChromelessWindow

本技能介绍如何实现和自定义 Syncfusion WPF ChromelessWindow。

何时使用此技能

• 需要使用标题栏可自定义的无边框/无装饰 WPF 窗口时。
• 需要自定义标题栏背景、高度、字体、图标或对齐方式时。
• 需要在标题栏左侧或右侧添加控件或自定义按钮时。
• 需要更改边框、圆角、调整大小行为或主题集成时。
• 需要了解窗口停靠时 UseNativeChrome 的行为时。

导航指南

按照以下链接打开各项任务对应的参考页面。

入门

📄 阅读： references/getting-started.md

• 将 ChromelessWindow 添加到项目中，了解基本属性和快速示例。

概述

📄 阅读： references/overview.md

• 功能概览和支持的场景。

标题栏自定义

📄 阅读： references/titlebar-customization.md

• 背景、高度、字体、可见性以及最大化/最小化按钮。

标题栏自定义按钮和控件

📄 阅读： references/titlebar-custom-buttons.md 📄 阅读： references/adding-controls.md

• 添加自定义按钮或自适应控件（左侧/右侧标题栏项）。

样式和模板

📄 阅读： references/styling.md

• TitleBar、TitleButton 的模板，以及覆盖默认样式。

边框和圆角

📄 阅读： references/border-customization.md 📄 阅读： references/corner-radius.md

• 调整大小边框颜色、粗细和圆角示例。

视觉结构和主题

📄 阅读： references/visual-structure.md 📄 阅读： references/set-visual-styles.md

• 视觉元素布局和主题应用指南。

原生窗口样式 / 停靠

📄 阅读： references/use-native-chrome.md

• UseNativeChrome 的行为和停靠说明。

终端用户功能

📄 阅读： references/end-user-capabilities.md

• 终端用户可以执行的操作（最大化、最小化、还原、调整大小）。

快速开始

最简 ChromelessWindow 示例（XAML）：

<syncfusion:ChromelessWindow x:Class="Chromelesswindow.MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:syncfusion="clr-namespace:Syncfusion.Windows.Shared;assembly=Syncfusion.Shared.WPF"
    Title="ChromelessWindow Sample" Height="350" Width="525"
    TitleBarBackground="#FF2D2D2D" TitleFontSize="14" TitleBarHeight="36">
    <Grid>
        
    </Grid>
</syncfusion:ChromelessWindow>

常见模式

• 使用 LeftHeaderItemsSource / RightHeaderItemsSource 添加自定义标题栏左侧/右侧项。
• 使用 TitleBarTemplate / TitleButtonTemplate 完全自定义视觉效果。
• 修改多个模板部分时，在 App.xaml 中覆盖默认样式。

故障排除

• 如果未显示最大化/最小化按钮，请检查 ResizeMode 和 ShowMaximizeButton/ShowMinimizeButton。
• 要确保可以通过拖动移动窗口，请确认模板中存在名为 PART_TitleBar 的 TitleBar。
• 如果难以调整大小，请增大 ResizeBorderThickness。
• 如果未应用自定义模板，请确认资源已包含在 App.xaml 中，且键匹配。