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 に含まれていることと、キーが一致していることを確認してください。