WindowChrome Klasse

Definition

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

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Vererbung

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Hinweise

Mit der WindowChrome Klasse können Sie Windows Presentation Foundation (WPF)-Inhalte in den Nicht-Clientbereich eines Fensters erweitern, das normalerweise für den Fenster-Manager des Betriebssystems reserviert ist.

Windows-Standard

Standardfenster bestehen aus zwei überlappenden Rechtecke. Das äußere Rechteck ist der Nicht-Clientbereich, der häufig als Chrom bezeichnet wird. Sie wird vom Fenster-Manager des Betriebssystems gezeichnet und verwaltet. Seine Abmessungen werden durch Standardeinstellungen des Betriebssystems bestimmt. Der Nicht-Clientframe stellt Standardfensterfeatures und -verhalten bereit. Dazu gehören Beschriftungsschaltflächen (Minimieren, Maximieren und Schließen), der Fensterrahmen, das Ändern der Größe und das Verschieben von Verhaltensweisen, das Anwendungssymbol und der Titel sowie das Systemmenü. Das innere Rechteck ist der Clientbereich. Sie enthält den Inhalt Ihrer Anwendung und wird von der Anwendung gezeichnet und verwaltet. Weitere Informationen zu Windows in WPF-Anwendungen finden Sie unter WPF Windows Overview.

Die folgende Abbildung zeigt die Teile eines Standardfensters.

Benutzerdefiniertes Windows

Sie können einen Fensterrahmen anpassen, indem Sie die Window.WindowStyle Eigenschaft auf None oder mithilfe der WindowChrome Klasse festlegen.

WindowStyle.None

Eine Möglichkeit zum Anpassen der Darstellung eines WPF-Anwendungsfensters ist das Festlegen der Window.WindowStyle Eigenschaft auf None. Dadurch wird der Nicht-Clientframe aus dem Fenster entfernt und nur der Clientbereich verlassen, auf den Sie eine benutzerdefinierte Formatvorlage anwenden können. Wenn der Nicht-Clientframe jedoch entfernt wird, verlieren Sie auch die Systemfeatures und -verhaltensweisen, die es bereitstellt, z. B. Beschriftungsschaltflächen und Fensteranpassungen. Ein weiterer Nebeneffekt ist, dass das Fenster die Windows-Taskleiste abdeckt, wenn sie maximiert wird. Die Einstellung WindowStyle.None ermöglicht es Ihnen, eine vollständig benutzerdefinierte Anwendung zu erstellen, erfordert aber auch, dass Sie benutzerdefinierte Logik in Ihrer Anwendung implementieren, um das Standardfensterverhalten zu emulieren.

WindowChrome

Um ein Fenster anzupassen, während die Standardfunktionalität beibehalten wird, können Sie die WindowChrome Klasse verwenden. Die WindowChrome Klasse trennt die Funktionalität des Fensterrahmens von den visuellen Elementen und ermöglicht es Ihnen, die Grenze zwischen dem Client und nicht clientseitigen Bereichen des Anwendungsfensters zu steuern. Mit WindowChrome der Klasse können Sie WPF-Inhalte im Fensterrahmen platzieren, indem Sie den Clientbereich erweitern, um den Nicht-Clientbereich abzudecken. Gleichzeitig behält es das Systemverhalten durch zwei unsichtbare Bereiche bei; die Größe von Rahmen - und Beschriftungsbereichen ändern.

Es gibt zwei Hauptteile zum Erstellen eines benutzerdefinierten Fensters mithilfe der WindowChrome Klasse. Zuerst passen Sie den Nicht-Clientteil des Fensters an, indem Sie eigenschaften festlegen, die für das WindowChrome Objekt verfügbar gemacht werden. Anschließend geben Sie eine Vorlage für das Fenster an, das den Teil Ihrer Anwendung definiert, der in den Nicht-Clientbereich erweitert wird. Die eigenschaften, die für das WindowChrome Objekt verfügbar gemacht werden, sind ResizeBorderThickness, CaptionHeight, CornerRadiusund GlassFrameThickness.

Die ResizeBorderThickness Eigenschaft gibt einen unsichtbaren Rahmen um die Außenseite des Anwendungsfensters an, auf den der Benutzer klicken und ziehen kann, um die Größe des Fensters zu ändern.

Die CaptionHeight Eigenschaft gibt einen unsichtbaren Bereich am oberen Rand des Fensters an, der systembedingte Verhaltensweisen ermöglicht, die normalerweise der Titelleiste zugeordnet sind. Zu diesen Verhaltensweisen gehören: Klicken und Ziehen, um das Fenster zu verschieben, doppelklicken Sie, um das Fenster zu maximieren, und klicken Sie mit der rechten Maustaste, um das Systemmenü anzuzeigen.

Der Rahmen und der Beschriftungsbereich für größenänderung weisen keine visuellen Elemente auf; sie definieren nur Bereiche, die auf Eingaben reagieren und standardmäßige vom System bereitgestellte Fensterverhalten aktivieren.

Die CornerRadius Eigenschaft gibt den Betrag an, in dem die Ecken des Fensters abgerundet werden. Diese Eigenschaft hat keine Auswirkung, wenn der Glasrahmen für ein Fenster aktiviert ist.

Die GlassFrameThickness Eigenschaft gibt die Breite des Glasrahmens um das Fenster an. Standardmäßig wird der von der WindowNonClientFrameThickness Eigenschaft angegebene Systemwert verwendet, um die Darstellung eines Standardfensters zu emulieren. Wenn der Glasrahmen verwendet wird, sind die Beschriftungsschaltflächen für Minimieren, Maximieren und Schließen sichtbar und interaktiv. Die Anwendung ist für die Anzeige des Anwendungssymbols und des Beschriftungstexts verantwortlich. Sie können die GlassFrameThickness Eigenschaft so festlegen, dass der Glasrahmen breiter oder schmaler als der Standardwert ist.

Um ein benutzerdefiniertes Fenster ohne Glasrahmen zu erstellen, legen Sie die GlassFrameThickness Eigenschaft auf einen einheitlichen Wert von 0 fest. Dadurch werden die Standardbeschriftungsschaltflächen deaktiviert und ausgeblendet.

Um den Glasrahmen so zu erweitern, dass es das gesamte Fenster abdeckt, legen Sie die GlassFrameThickness Eigenschaft auf einen negativen Wert auf jeder Seite fest. Wenn die GlassFrameThickness Eigenschaft auf einen negativen Wert für jede Seite festgelegt wird, ist der koercierte Wert gleich GlassFrameCompleteThickness.

Windows Aero-Glaseffekte werden auf allen Betriebssystemen nicht unterstützt und können auf unterstützten Betriebssystemen deaktiviert werden. Wenn Windows Aero nicht verfügbar ist, wird der Glasrahmen unabhängig vom GlassFrameThickness Eigenschaftswert nicht angezeigt. Der durch diese Eigenschaft angegebene Rahmenbereich wird stattdessen schwarz angezeigt. Überprüfen Sie die IsGlassEnabled Eigenschaft, um sicherzustellen, dass Windows Aero-Glaseffekte verfügbar sind. Wenn keine Glaseffekte verfügbar sind, sollten Sie einen alternativen Fensterstil bereitstellen, der den Glasrahmen nicht verwendet, oder das Standardfenster verwenden, indem Sie die Fensterformatvorlage auf NULL festlegen.

Sie erweitern den WPF-Inhalt in den Fensterrahmen, indem Sie eine ControlTemplate angeben, die das Aussehen und Verhalten des Frameinhalts definiert. Sie legen den TargetType der ControlTemplate auf den Typ des Fensters fest, das Sie anpassen möchten.

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

Standardmäßig sind die Teile aller visuellen Elemente, die sich im Nicht-Clientbereich des Fensters befinden, nicht interaktiv. Um interaktive Elemente im Nicht-Client-Bereich zu aktivieren, fügen Sie die angefügte WindowsChrome.IsHitTestVisibleInChrome-Eigenschaft an das Element an, und legen Sie sie auf "true" fest.

Das folgende XAML-Markup zeigt die wichtigsten Elemente, die zum Anpassen eines Fensters mit der WindowChrome-Klasse erforderlich sind.

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

Der erste Setter fügt das WindowChrome an das Fenster an. Es verwendet alle Standardwerte für die WindowChrome-Eigenschaften, wodurch das Fenster wie ein Standardfenster aussieht.

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

Die Fenstervorlage muss einen Inhaltsreferent angeben, um den Inhalt des in der Anwendung angegebenen Fensters anzuzeigen. Standardmäßig erweitert die WindowChrome-Klasse den Clientbereich, um den Nicht-Client-Rahmen abzudecken. Um den Glasrahmen aufzudecken, müssen Sie einen Rand um den ContentPresenter angeben. Dieses Markup gibt einen Rahmen mit einem weißen Hintergrund um den Inhaltsreferent an, um die Darstellung eines Standardfensters zu emulieren. Außerdem wird ein Rand angegeben, der an die WindowNonClientFrameThickness-Eigenschaft gebunden ist, die die Standardsystembreite für den Frame abruft.

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

Das Anwendungssymbol und der Titel werden nicht von der WindowChrome-Klasse angezeigt. sie müssen dem Rahmen als benutzerdefinierter Inhalt hinzugefügt werden. Der folgende XAML-Code fügt ein Bild und einen Textblock hinzu, um das Symbol und den Titel anzuzeigen. Beide Elemente sind an die entsprechenden Eigenschaften im Fenster gebunden. Die Bildbreite ist an die SmallIconSize-Breite gebunden, die die Standardsystemgröße für das Symbol abruft. Die angefügte IsHitTestVisibleInChrome-Eigenschaft wird für das Bild festgelegt, sodass sie Mausereignisse empfangen kann.

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