WindowChrome Klas

Definitie

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

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Overname

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Opmerkingen

Met de klasse WindowChrome kunt u Windows Presentation Foundation (WPF) inhoud uitbreiden naar het niet-clientgebied van een venster dat doorgaans is gereserveerd voor vensterbeheer van het besturingssysteem.

Standard-Windows

Standaardvensters bestaan uit twee overlappende rechthoeken. De buitenste rechthoek is het niet-clientgebied, dat vaak chrome wordt genoemd. Het wordt getekend en beheerd door het vensterbeheer van het besturingssysteem. De afmetingen worden bepaald door de standaardinstellingen van het besturingssysteem. Het niet-clientframe biedt standaardvensterfuncties en -gedrag. Dit zijn onder andere bijschriftknoppen (Minimaliseren, Maximaliseren en Sluiten), de vensterrand, het gedrag van de toepassing, het toepassingspictogram en de titel en het systeemmenu. De binnenste rechthoek is het clientgebied. Deze bevat de inhoud van uw toepassing en wordt getekend en beheerd door de toepassing. Zie WPF Windows Overview voor meer informatie over windows in WPF toepassingen.

In de volgende afbeelding ziet u de onderdelen van een standaardvenster.

Aangepaste Windows

U kunt een vensterrand aanpassen door de Window.WindowStyle eigenschap in te None stellen op of met behulp van de WindowChrome klasse.

WindowStyle.None

Een manier om het uiterlijk van een WPF toepassingsvenster aan te passen, is door de eigenschap Window.WindowStyle in te stellen op None. Hiermee verwijdert u het niet-clientframe uit het venster en blijft alleen het clientgebied behouden waarop u een aangepaste stijl kunt toepassen. Wanneer het niet-clientframe echter wordt verwijderd, verliest u ook de systeemfuncties en het gedrag dat het biedt, zoals bijschriftknoppen en venstergrootte. Een ander neveneffect is dat het venster de Windows taakbalk bedekt wanneer deze wordt gemaximaliseerd. Met de instelling WindowStyle.None kunt u een volledig aangepaste toepassing maken, maar u moet ook aangepaste logica in uw toepassing implementeren om standaardvenstergedrag te emuleren.

WindowChrome

Als u een venster wilt aanpassen terwijl de standaardfunctionaliteit behouden blijft, kunt u de WindowChrome klasse gebruiken. De WindowChrome klasse scheidt de functionaliteit van het vensterframe van de visuals en stelt u in staat om de grens tussen de client- en niet-clientgebieden van uw toepassingsvenster te bepalen. Met de klasse WindowChrome kunt u WPF inhoud in het vensterframe plaatsen door het clientgebied uit te breiden om het niet-clientgebied te bedekken. Tegelijkertijd behoudt het systeemgedrag via twee onzichtbare gebieden; de grootte van de rand - en bijschriftgebieden wijzigen.

Er zijn twee hoofdonderdelen voor het maken van een aangepast venster met behulp van de WindowChrome klasse. Eerst past u het niet-clientgedeelte van het venster aan door eigenschappen in te stellen die beschikbaar zijn voor het WindowChrome object. Vervolgens geeft u een sjabloon op voor het venster dat het deel van uw toepassing definieert dat is uitgebreid in het niet-clientgebied. De eigenschappen die op het WindowChrome object worden weergegeven, zijn ResizeBorderThickness, CaptionHeighten GlassFrameThicknessCornerRadius.

De ResizeBorderThickness eigenschap geeft een onzichtbare rand rond de buitenkant van het toepassingsvenster op dat de gebruiker kan klikken en slepen om het formaat van het venster te wijzigen.

De CaptionHeight eigenschap geeft een onzichtbaar gebied boven aan het venster op dat systeemgedrag mogelijk maakt dat doorgaans is gekoppeld aan de titelbalk. Dit gedrag is onder andere: klik en sleep om het venster te verplaatsen, dubbelklik om het venster te maximaliseren en klik met de rechtermuisknop om het systeemmenu weer te geven.

Het formaat van de rand en het bijschriftgebied hebben geen visuele elementen; ze definiëren alleen gebieden die reageren op invoer en standaard door het systeem geleverde venstergedrag inschakelen.

De CornerRadius eigenschap geeft de hoeveelheid aan die de hoeken van het venster worden afgerond. Deze eigenschap heeft geen effect als het glazen frame is ingeschakeld voor een venster.

De GlassFrameThickness eigenschap geeft de breedte van het glazen frame rond het raam. Standaard wordt de systeemwaarde gebruikt die door de WindowNonClientFrameThickness eigenschap is opgegeven om het uiterlijk van een standaardvenster te emuleren. Wanneer het glazen frame wordt gebruikt, zijn de bijschriftknoppen voor Minimaliseren, Maximaliseren en Sluiten zichtbaar en interactief. De toepassing is verantwoordelijk voor het weergeven van het toepassingspictogram en de bijschrifttekst. U kunt de GlassFrameThickness eigenschap instellen om het glazen frame breder of smaller te maken dan de standaardinstelling.

Als u een aangepast venster wilt maken dat geen glazen frame heeft, stelt u de GlassFrameThickness eigenschap in op een uniforme waarde van 0. Hiermee worden de standaardbijschriftknoppen uitgeschakeld en verborgen.

Als u het glazen frame wilt uitbreiden om het hele venster te bedekken, stelt u de GlassFrameThickness eigenschap in op een negatieve waarde aan een willekeurige zijde. Wanneer de GlassFrameThickness eigenschap is ingesteld op een negatieve waarde voor een willekeurige zijde, is de coerced-waarde gelijk aan GlassFrameCompleteThickness.

Windows Aero glaseffecten worden niet ondersteund op alle besturingssystemen en kunnen worden uitgeschakeld op ondersteunde besturingssystemen. Als Windows Aero niet beschikbaar is, wordt het glazen frame niet weergegeven, ongeacht de eigenschapswaarde GlassFrameThickness. Het door deze eigenschap opgegeven randgebied wordt in plaats daarvan zwart weergegeven. Controleer de eigenschap IsGlassEnabled om te controleren of Windows Aero-glaseffecten beschikbaar zijn. Als glaseffecten niet beschikbaar zijn, moet u een alternatieve vensterstijl opgeven die het glazen frame niet gebruikt of het standaardvenster gebruiken door de vensterstijl in te stellen op null.

U breidt uw WPF inhoud uit naar het vensterframe door een ControlTemplate op te geven waarmee het uiterlijk en gedrag van de frameinhoud wordt gedefinieerd. U stelt het TargetType van controlTemplate in op het type venster dat u wilt aanpassen.

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

Standaard zijn de onderdelen van visuele elementen die zich in het niet-clientgebied van het venster bevinden, niet interactief. Als u interactieve elementen in het niet-clientgebied wilt inschakelen, koppelt u de eigenschap WindowsChrome.IsHitTestVisibleInChrome aan het element en stelt u deze in op waar.

In de volgende XAML-markering ziet u de belangrijkste elementen die nodig zijn om een venster aan te passen met behulp van de klasse 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>

De eerste setter koppelt het VensterChrome aan het venster. Het maakt gebruik van alle standaardwaarden voor de eigenschappen WindowChrome, waardoor het venster eruitziet als een standaardvenster.

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

De venstersjabloon moet een inhoudspresentator opgeven om de inhoud van het venster weer te geven dat is opgegeven in uw toepassing. De WindowChrome-klasse breidt standaard het clientgebied uit om de rand van de niet-client te dekken. Als u het glazen frame wilt ontdekken, moet u een marge rond de ContentPresenter opgeven. Met deze markering wordt een rand met een witte achtergrond rond de inhoudspresentator opgegeven om het uiterlijk van een standaardvenster te emuleren. Er wordt ook een marge opgegeven die is gebonden aan de eigenschap WindowNonClientFrameThickness, waarmee de standaardsysteembreedte voor het frame wordt ophaalt.

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

Het toepassingspictogram en de titel worden niet weergegeven door de klasse WindowChrome; ze moeten als aangepaste inhoud aan de rand worden toegevoegd. De volgende XAML voegt een afbeelding en een tekstblok toe om het pictogram en de titel weer te geven. Beide elementen zijn gebonden aan de bijbehorende eigenschappen in het venster. De breedte van de afbeelding is gebonden aan de Breedte van SmallIconSize, waarmee de standaardsysteemgrootte voor het pictogram wordt opgehaald. De gekoppelde eigenschap IsHitTestVisibleInChrome is ingesteld op de afbeelding, zodat deze muis-gebeurtenissen kan ontvangen.

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