WindowChrome Classe

Définition

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

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Héritage

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Remarques

La WindowChrome classe vous permet d’étendre le contenu WINDOWS Presentation Foundation (WPF) dans la zone non cliente d’une fenêtre qui est généralement réservée au gestionnaire de fenêtres du système d’exploitation.

Standard Windows

Les fenêtres standard sont composées de deux rectangles qui se chevauchent. Le rectangle externe est la zone non cliente, souvent appelée chrome. Il est dessiné et géré par le gestionnaire de fenêtres du système d’exploitation. Ses dimensions sont déterminées par les paramètres de système d’exploitation standard. Le cadre non client fournit des fonctionnalités et des comportements de fenêtre standard. Ces boutons incluent les boutons de légende (Réduire, Agrandir et Fermer), la bordure de la fenêtre, redimensionner et déplacer les comportements, l’icône et le titre de l’application, ainsi que le menu système. Le rectangle interne est la zone cliente. Il contient le contenu de votre application, et il est dessiné et géré par l’application. Pour plus d’informations sur les fenêtres dans les applications WPF, consultez Vue d’ensemble de WPF Windows.

L’illustration suivante montre les parties d’une fenêtre standard.

Windows personnalisé

Vous pouvez personnaliser une bordure de fenêtre en définissant la Window.WindowStyle propriété sur None ou en utilisant la WindowChrome classe.

WindowStyle.None

Une façon de personnaliser l’apparence d’une fenêtre d’application WPF consiste à définir la Window.WindowStyle propriété Nonesur . Cela supprime le cadre non client de la fenêtre et laisse uniquement la zone cliente à laquelle vous pouvez appliquer un style personnalisé. Toutefois, lorsque le cadre non client est supprimé, vous perdez également les fonctionnalités système et les comportements qu’il fournit, tels que les boutons de légende et le redimensionnement de fenêtre. Un autre effet secondaire est que la fenêtre couvre la barre des tâches Windows lorsqu’elle est agrandie. Le paramètre WindowStyle.None vous permet de créer une application complètement personnalisée, mais nécessite également que vous implémentez une logique personnalisée dans votre application pour émuler le comportement de fenêtre standard.

WindowChrome

Pour personnaliser une fenêtre tout en conservant ses fonctionnalités standard, vous pouvez utiliser la WindowChrome classe. La WindowChrome classe sépare les fonctionnalités du cadre de fenêtre des visuels et vous permet de contrôler la limite entre le client et les zones non clientes de votre fenêtre d’application. La WindowChrome classe vous permet de placer du contenu WPF dans le cadre de la fenêtre en étendant la zone cliente pour couvrir la zone non cliente. En même temps, il conserve les comportements du système par le biais de deux zones invisibles ; redimensionner les zones de bordure et de légende .

Il existe deux parties principales pour créer une fenêtre personnalisée à l’aide de la WindowChrome classe. Tout d’abord, vous personnalisez la partie non cliente de la fenêtre en définissant les propriétés exposées sur l’objet WindowChrome . Ensuite, vous fournissez un modèle pour la fenêtre qui définit la partie de votre application étendue dans la zone non cliente. Les propriétés exposées sur l’objet WindowChrome sont ResizeBorderThickness, CaptionHeight, CornerRadiuset GlassFrameThickness.

La ResizeBorderThickness propriété spécifie une bordure invisible autour de l’extérieur de la fenêtre d’application que l’utilisateur peut cliquer et faire glisser pour redimensionner la fenêtre.

La CaptionHeight propriété spécifie une zone invisible en haut de la fenêtre qui active les comportements système généralement associés à la barre de titre. Ces comportements incluent : cliquer et faire glisser pour déplacer la fenêtre, double-cliquer pour agrandir la fenêtre, puis cliquer avec le bouton droit pour afficher le menu système.

La bordure de redimensionnement et la zone de légende n’ont aucun élément visuel ; ils définissent uniquement les zones qui répondent aux entrées et activent les comportements de fenêtre fournis par le système standard.

La CornerRadius propriété spécifie la quantité que les angles de la fenêtre sont arrondis. Cette propriété n’a aucun effet si le cadre en verre est activé pour une fenêtre.

La GlassFrameThickness propriété spécifie la largeur du cadre en verre autour de la fenêtre. Par défaut, elle utilise la valeur système spécifiée par la WindowNonClientFrameThickness propriété pour émuler l’apparence d’une fenêtre standard. Lorsque le cadre en verre est utilisé, les boutons de légende pour Réduire, Agrandir et Fermer sont visibles et interactifs. L’application est responsable de l’affichage de l’icône de l’application et du texte de légende. Vous pouvez définir la propriété pour rendre le GlassFrameThickness cadre en verre plus large ou plus étroit que la valeur par défaut.

Pour créer une fenêtre personnalisée qui n’a pas de cadre en verre, définissez la GlassFrameThickness propriété sur une valeur uniforme de 0. Cela désactive et masque les boutons de légende standard.

Pour étendre le cadre en verre pour couvrir toute la fenêtre, définissez la GlassFrameThickness propriété sur une valeur négative de n’importe quel côté. Lorsque la GlassFrameThickness propriété est définie sur une valeur négative pour n’importe quel côté, sa valeur coerced est égale à GlassFrameCompleteThickness.

Les effets de verre Windows Aero ne sont pas pris en charge sur tous les systèmes d’exploitation et peuvent être désactivés sur les systèmes d’exploitation pris en charge. Si Windows Aero n’est pas disponible, le cadre en verre ne s’affiche pas, quelle que soit la valeur de la GlassFrameThickness propriété. La zone de bordure spécifiée par cette propriété apparaît en noir à la place. Vérifiez la IsGlassEnabled propriété pour vérifier que les effets de verre Windows Aero sont disponibles. Si les effets de verre ne sont pas disponibles, vous devez fournir un autre style de fenêtre qui n’utilise pas le cadre en verre ou en utilisant la fenêtre standard en définissant le style de fenêtre sur Null.

Vous étendez votre contenu WPF dans le cadre de la fenêtre en spécifiant un ControlTemplate qui définit l’apparence et le comportement du contenu du cadre. Vous définissez TargetType du ControlTemplate sur le type de la fenêtre que vous personnalisez.

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

Par défaut, les parties des éléments visuels qui se trouvent dans la zone non cliente de la fenêtre ne sont pas interactives. Pour activer des éléments interactifs dans la zone non cliente, attachez la propriété jointe WindowsChrome.IsHitTestVisibleInChrome à l’élément et définissez-la sur true.

Le balisage XAML suivant montre les principaux éléments nécessaires pour personnaliser une fenêtre à l’aide de la classe 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>

Le premier setter attache la fenêtre WindowChrome à la fenêtre. Elle utilise toutes les valeurs par défaut pour les propriétés WindowChrome, ce qui rend la fenêtre semblable à une fenêtre standard.

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

Le modèle de fenêtre doit spécifier un présentateur de contenu pour afficher le contenu de la fenêtre spécifiée dans votre application. Par défaut, la classe WindowChrome étend la zone cliente pour couvrir la bordure non cliente. Pour découvrir le cadre en verre, vous devez spécifier une marge autour de ContentPresenter. Ce balisage spécifie une bordure avec un arrière-plan blanc autour du présentateur de contenu pour émuler l’apparence d’une fenêtre standard. Elle spécifie également une marge liée à la propriété WindowNonClientFrameThickness, qui obtient la largeur système par défaut du cadre.

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

L’icône et le titre de l’application ne sont pas affichés par la classe WindowChrome ; ils doivent être ajoutés à la bordure en tant que contenu personnalisé. Le code XAML suivant ajoute une image et un bloc de texte pour afficher l’icône et le titre. Les deux éléments sont liés aux propriétés correspondantes sur la fenêtre. La largeur de l’image est liée à la largeur SmallIconSize, qui obtient la taille système par défaut de l’icône. La propriété jointe IsHitTestVisibleInChrome est définie sur l’image afin qu’elle puisse recevoir des événements de souris.

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