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

Standard Windows

Standardfenster bestehen aus zwei überlappenden Rechtecken. 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. Die Abmessungen werden von den Standardbetriebssystemeinstellungen bestimmt. Der Nicht-Clientframe bietet Standardmäßige Fensterfeatures und -verhaltensweisen. Dazu gehören Untertitel Schaltflächen (Minimieren, Maximieren und Schließen), der Fensterrahmen, das Ändern der Größe und des Bewegungsverhaltens, 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 Übersicht über WPF-Windows.

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 besteht darin, die Window.WindowStyle -Eigenschaft auf festzulegen None. Dadurch wird der Nicht-Clientframe aus dem Fenster entfernt und nur der Clientbereich belässt, auf den Sie eine benutzerdefinierte Formatvorlage anwenden können. Wenn der Nicht-Clientframe entfernt wird, verlieren Sie jedoch auch die Systemfeatures und -verhaltensweisen, die er bietet, z. B. Untertitel Schaltflächen und Größenänderung von Fenstern. Ein weiterer Nebeneffekt ist, dass das Fenster die Windows-Taskleiste abdeckt, wenn es 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 Standardverhalten von Fenstern zu emulieren.

WindowChrome

Zum Anpassen eines Fensters unter Beibehaltung der Standardfunktionalität können Sie die WindowChrome -Klasse verwenden. Die WindowChrome -Klasse trennt die Funktionalität des Fensterrahmens von den Visuals und ermöglicht es Ihnen, die Grenze zwischen dem Client- und dem Nichtclientbereich Ihres 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; Ändern der Größe des Rahmens und Untertitel Bereiche.

Es gibt zwei Standard Teile zum Erstellen eines benutzerdefinierten Fensters mithilfe der WindowChrome -Klasse. Zunächst passen Sie den nicht clientbezogenen Teil des Fensters an, indem Sie eigenschaften festlegen, die für das WindowChrome Objekt verfügbar gemacht werden. Anschließend stellen Sie eine Vorlage für das Fenster bereit, die den Teil Ihrer Anwendung definiert, der in den Nichtclientbereich erweitert wird. Die für das WindowChrome -Objekt verfügbaren Eigenschaften sind ResizeBorderThickness, CaptionHeightCornerRadius, und GlassFrameThickness.

Die ResizeBorderThickness -Eigenschaft gibt einen unsichtbaren Rahmen außerhalb 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 Systemverhalten ermöglicht, das normalerweise der Titelleiste zugeordnet ist. Zu diesen Verhaltensweisen gehören: Klicken und Ziehen, um das Fenster zu verschieben, Doppelklicken, um das Fenster zu maximieren, und klicken Sie mit der rechten Maustaste, um das Systemmenü anzuzeigen.

Der Rahmen für die Größenänderung und der Untertitel Bereichs weisen keine visuellen Elemente auf. Sie definieren nur Bereiche, die auf Eingaben reagieren und standardmäßig vom System bereitgestelltes Fensterverhalten ermöglichen.

Die CornerRadius -Eigenschaft gibt den Betrag an, in dem die Ecken des Fensters gerundet 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 Untertitel Schaltflächen für Minimieren, Maximieren und Schließen sichtbar und interaktiv. Die Anwendung ist für die Anzeige des Anwendungssymbols und Untertitel Text verantwortlich. Sie können die GlassFrameThickness -Eigenschaft so festlegen, dass der Glasrahmen breiter oder schmaler als die Standardeinstellung ist.

Um ein benutzerdefiniertes Fenster ohne Glasrahmen zu erstellen, legen Sie die GlassFrameThickness -Eigenschaft auf den einheitlichen Wert 0 fest. Dadurch werden die Standardschaltflächen Untertitel deaktiviert und ausgeblendet.

Um den Glasrahmen so zu erweitern, dass er das gesamte Fenster abdeckt, legen Sie die GlassFrameThickness -Eigenschaft auf einer beliebigen Seite auf einen negativen Wert fest. Wenn die GlassFrameThickness -Eigenschaft auf einen negativen Wert für eine beliebige Seite festgelegt wird, ist ihr koerzierter Wert gleich GlassFrameCompleteThickness.

Windows Aero-Glaseffekte werden nicht auf allen Betriebssystemen 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 von dieser 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 angeben, der nicht den Glasrahmen verwendet, oder das Standardfenster verwenden, indem Sie die Fensterformatvorlage auf NULL festlegen.

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

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

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

Das folgende XAML-Markup zeigt die Standard Elemente, die zum Anpassen eines Fensters mithilfe 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 windowChrome an das Fenster an. Es werden alle Standardwerte für die WindowChrome-Eigenschaften verwendet, wodurch das Fenster wie ein Standardfenster aussieht.

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

Die Fenstervorlage muss einen Inhaltsreferenten angeben, um den Inhalt des in Der Anwendung angegebenen Fensters anzuzeigen. Standardmäßig erweitert die WindowChrome-Klasse den Clientbereich, um den Nicht-Clientrahmen abzudecken. Um den Glasrahmen freizulegen, müssen Sie einen Rand um den ContentPresenter angeben. Dieses Markup gibt einen Rahmen mit weißem Hintergrund um den Inhaltsmoderator 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 von der WindowChrome-Klasse nicht 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 Mausereignisse empfangen werden können.

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

Konstruktoren

Felder

Eigenschaften

Angefügte Eigenschaften

Methoden

Ereignisse

Gilt für: