WindowChrome クラス

定義

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) コンテンツを、オペレーティング システムのウィンドウ マネージャー用に通常予約されているウィンドウのクライアント以外の領域に拡張できます。

Standard Windows

標準ウィンドウは、2 つの重なり合う四角形で構成されます。 外側の四角形は、多くの場合、クロムと呼ばれる非クライアント領域です。 これは、オペレーティング システムのウィンドウ マネージャーによって描画および管理されます。 そのディメンションは、標準のオペレーティング システム設定によって決まります。 クライアント以外のフレームには、標準のウィンドウ機能と動作が用意されています。 これには、キャプション ボタン (最小化、最大化、閉じる)、ウィンドウの境界線、サイズ変更と移動の動作、アプリケーション アイコンとタイトル、システム メニューが含まれます。 内側の四角形は クライアント領域です。 アプリケーションの内容が含まれており、アプリケーションによって描画および管理されます。 WPF アプリケーションのウィンドウの詳細については、「 WPF Windows の概要」を参照してください。

次の図は、標準ウィンドウの部分を示しています。

カスタム ウィンドウ

ウィンドウの境界線をカスタマイズするには、 プロパティを Window.WindowStyle に None 設定するか、 クラスを WindowChrome 使用します。

WindowStyle.None

WPF アプリケーション ウィンドウの外観をカスタマイズする 1 つの方法は、 プロパティを Window.WindowStyle に設定することです None。 これにより、非クライアント フレームがウィンドウから削除され、カスタム スタイルを適用できるクライアント領域のみが残ります。 ただし、クライアント以外のフレームが削除されると、キャプションボタンやウィンドウのサイズ変更など、システムの機能と動作も失われます。 もう 1 つの副作用は、ウィンドウが最大化されたときに Windows タスク バーをカバーすることです。 を設定 WindowStyle.None すると、完全にカスタム アプリケーションを作成できますが、標準ウィンドウの動作をエミュレートするために、アプリケーションにカスタム ロジックを実装する必要もあります。

WindowChrome

標準機能を保持したままウィンドウをカスタマイズするには、 クラスを WindowChrome 使用できます。 クラスは WindowChrome 、ウィンドウ フレームの機能をビジュアルから分離し、アプリケーション ウィンドウのクライアント領域とクライアント以外の領域の境界を制御できます。 WindowChromeクラスを使用すると、クライアント領域を拡張してクライアント以外の領域をカバーすることで、WPF コンテンツをウィンドウ フレームに配置できます。 同時に、2つの目に見えない領域を通じてシステムの動作を保持します。境界線とキャプション領域のサイズを変更します。

クラスを使用してWindowChromeカスタム ウィンドウを作成するには、2 つのメインパーツがあります。 最初に、 オブジェクトに公開されるプロパティを設定して、ウィンドウのクライアント以外の部分を WindowChrome カスタマイズします。 次に、クライアント以外の領域に拡張されるアプリケーションの部分を定義するウィンドウのテンプレートを指定します。 オブジェクトでWindowChrome公開されるプロパティは、ResizeBorderThickness、、CaptionHeightCornerRadius、および GlassFrameThicknessです。

プロパティは ResizeBorderThickness 、ユーザーがクリックアンドドラッグしてウィンドウのサイズを変更できる、アプリケーション ウィンドウの外側の非表示の境界線を指定します。

プロパティは CaptionHeight 、通常、タイトル バーに関連付けられているシステム動作を可能にする、ウィンドウの上部にある非表示領域を指定します。 これらの動作には、クリックしてドラッグしてウィンドウを移動する、ダブルクリックしてウィンドウを最大化する、右クリックしてシステム メニューを表示するなどがあります。

サイズ変更の境界線とキャプション領域には視覚的な要素はありません。入力に応答し、標準のシステム提供のウィンドウ動作を有効にする領域のみを定義します。

プロパティは CornerRadius 、ウィンドウの角を丸める量を指定します。 ウィンドウに対してガラス フレームが有効になっている場合、このプロパティは効果がありません。

プロパティは GlassFrameThickness 、ウィンドウの周囲のガラス フレームの幅を指定します。 既定では、 プロパティで指定されたシステム値を WindowNonClientFrameThickness 使用して、標準ウィンドウの外観をエミュレートします。 ガラス フレームを使用すると、[最小化]、[最大化]、[閉じる] のキャプション ボタンが表示され、対話型になります。 アプリケーションは、アプリケーション アイコンを表示し、テキストをキャプションします。 プロパティを GlassFrameThickness 設定して、ガラスフレームを既定よりも広くまたは狭くすることができます。

ガラス枠のないカスタム ウィンドウを作成するには、 プロパティを GlassFrameThickness 均一値の 0 に設定します。 これにより、標準のキャプション ボタンが無効になり、非表示になります。

ウィンドウ全体をカバーするようにガラス フレームを拡張するには、 プロパティを任意の GlassFrameThickness 側の負の値に設定します。 プロパティが任意の GlassFrameThickness 辺の負の値に設定されている場合、強制値は と GlassFrameCompleteThickness等しくなります。

Windows Aero Glass の効果は、すべてのオペレーティング システムでサポートされているわけではありません。サポートされているオペレーティング システムでは無効にすることができます。 Windows Aero が使用できない場合、プロパティ値に関係なく GlassFrameThickness ガラス フレームは表示されません。 このプロパティで指定された境界線領域は、代わりに黒で表示されます。プロパティを IsGlassEnabled 確認して、Windows Aero ガラス効果が使用可能であることを確認します。 ガラス効果を使用できない場合は、ガラス 枠を使用しない代替ウィンドウ スタイルを指定するか、ウィンドウ スタイルを null に設定して標準ウィンドウを使用する必要があります。

WPF コンテンツをウィンドウ フレームに拡張するには、フレーム コンテンツの外観と動作を定義する ControlTemplate を指定します。 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>

最初のセッターは、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"/>

コンストラクター

フィールド

プロパティ

添付プロパティ

メソッド

イベント

適用対象