WindowChrome Klass

Definition

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

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Arv

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Kommentarer

Med klassen WindowChrome kan du utöka Windows Presentation Foundation (WPF) innehåll till området icke-klient i ett fönster som vanligtvis är reserverat för operativsystemets fönsterhanterare.

Standard Windows

Standardfönster består av två överlappande rektanglar. Den yttre rektangeln är det icke-klientområde som ofta kallas krom. Den ritas och hanteras av operativsystemets fönsterhanterare. Dess dimensioner bestäms av standardinställningarna för operativsystemet. Den icke-klientramen innehåller standardfunktioner och beteenden för fönster. Dessa inkluderar bildtextknappar (Minimera, Maximera och Stäng), fönstrets kantlinje, ändra storlek på och flytta beteenden, programikonen och rubriken och systemmenyn. Den inre rektangeln är klientområdet. Den innehåller innehållet i ditt program och det ritas och hanteras av programmet. Mer information om windows i WPF program finns i WPF Windows Overview.

Följande bild visar delarna i ett standardfönster.

Anpassad Windows

Du kan anpassa en fönsterkantlinje genom att ange Window.WindowStyle egenskapen till None eller med hjälp WindowChrome av klassen .

WindowStyle.None

Ett sätt att anpassa utseendet på ett WPF programfönster är att ange egenskapen Window.WindowStyle till None. Detta tar bort den icke-klientramen från fönstret och lämnar endast klientområdet, som du kan använda ett anpassat format för. Men när den icke-klientramen tas bort förlorar du även de systemfunktioner och beteenden som den tillhandahåller, till exempel bildtextknappar och storleksändring av fönster. En annan bieffekt är att fönstret täcker Windows aktivitetsfältet när det maximeras. Med inställningen WindowStyle.None kan du skapa ett helt anpassat program, men kräver också att du implementerar anpassad logik i ditt program för att emulera standardfönstrets beteende.

WindowChrome

Om du vill anpassa ett fönster samtidigt som du behåller dess standardfunktioner kan du använda WindowChrome klassen. Klassen WindowChrome separerar funktionerna i fönsterramen från de visuella objekten och låter dig styra gränsen mellan klient- och icke-klientområdena i programfönstret. Med klassen WindowChrome kan du placera WPF innehåll i fönsterramen genom att utöka klientområdet så att det täcker området som inte är klient. Samtidigt behåller den systembeteenden genom två osynliga områden. ändra storlek på kantlinjer och textområden .

Det finns två huvuddelar för att skapa ett anpassat fönster med hjälp av WindowChrome klassen. Först anpassar du den icke-klientdel av fönstret genom att ange egenskaper som exponeras för WindowChrome objektet. Sedan anger du en mall för fönstret som definierar den del av programmet som utökas till området som inte är klient. Egenskaperna som exponeras för WindowChrome objektet är ResizeBorderThickness, CaptionHeight, CornerRadiusoch GlassFrameThickness.

Egenskapen ResizeBorderThickness anger en osynlig kantlinje utanför programfönstret som användaren kan klicka och dra för att ändra storlek på fönstret.

Egenskapen CaptionHeight anger ett osynligt område överst i fönstret som möjliggör systembeteenden som vanligtvis är associerade med namnlisten. Dessa beteenden omfattar: klicka och dra för att flytta fönstret, dubbelklicka för att maximera fönstret och högerklicka för att visa systemmenyn.

Området ändra storlek på kantlinje och bildtext har inga visuella element. de definierar endast områden som svarar på indata och aktiverar standardsystembaserade fönsterbeteenden.

Egenskapen CornerRadius anger hur mycket fönstrets hörn avrundas. Den här egenskapen har ingen effekt om glasramen är aktiverad för ett fönster.

Egenskapen GlassFrameThickness anger bredden på glasramen runt fönstret. Som standard använder den det systemvärde som anges av WindowNonClientFrameThickness egenskapen för att emulera utseendet på ett standardfönster. När glasramen används visas bildtextknapparna för Minimera, Maximera och Stäng och interaktiva. Programmet ansvarar för att visa programikonen och texttexten. Du kan ange egenskapen GlassFrameThickness så att glasramen blir bredare eller smalare än standardvärdet.

Om du vill skapa ett anpassat fönster som inte har en glasram anger du GlassFrameThickness egenskapen till ett enhetligt värde på 0. Detta inaktiverar och döljer standardrubrikknapparna.

Om du vill utöka glasramen så att den täcker hela fönstret anger du GlassFrameThickness egenskapen till ett negativt värde på valfri sida. När egenskapen GlassFrameThickness är inställd på ett negativt värde för alla sidor är dess framtvingade värde lika med GlassFrameCompleteThickness.

Windows Aero-glaseffekter stöds inte på alla operativsystem och kan inaktiveras på operativsystem som stöds. Om Windows Aero inte är tillgängligt visas inte glasramen oavsett egenskapsvärdet GlassFrameThickness. Det kantlinjeområde som anges av den här egenskapen visas i stället som svart. Kontrollera egenskapen IsGlassEnabled för att kontrollera att Windows Aero-glaseffekter är tillgängliga. Om glaseffekter inte är tillgängliga bör du ange ett alternativt fönsterformat som inte använder glasramen eller använda standardfönstret genom att ange fönsterformatet till null.

Du utökar ditt WPF innehåll till fönsterramen genom att ange ett ControlTemplate som definierar utseendet och beteendet för raminnehållet. Du anger TargetType för ControlTemplate till den typ av fönster som du anpassar.

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

Som standard är de delar av alla visuella element som finns i fönstrets icke-klientområde inte interaktiva. Om du vill aktivera interaktiva element i området som inte är klient kopplar du den anslutna egenskapen WindowsChrome.IsHitTestVisibleInChrome till elementet och anger det till true.

Följande XAML-markering visar de viktigaste elementen som behövs för att anpassa ett fönster med klassen 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>

Den första settern kopplar WindowChrome till fönstret. Den använder alla standardvärden för WindowChrome-egenskaperna, vilket gör att fönstret ser ut som ett standardfönster.

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

Fönstermallen måste ange en innehållspresentatör för att visa innehållet i fönstret som anges i programmet. Som standard utökar klassen WindowChrome klientområdet så att det täcker den icke-klientkantlinje. För att kunna upptäcka glasramen måste du ange en marginal runt ContentPresenter. Den här markeringen anger en kantlinje med en vit bakgrund runt innehållspresentatören för att emulera utseendet på ett standardfönster. Den anger också en marginal som är bunden till egenskapen WindowNonClientFrameThickness, som hämtar standardsystembredden för ramen.

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

Programikonen och rubriken visas inte av klassen WindowChrome. de måste läggas till i kantlinjen som anpassat innehåll. Följande XAML lägger till en bild och en textblockering för att visa ikonen och rubriken. Båda elementen är bundna till motsvarande egenskaper i fönstret. Bildbredden är bunden till SmallIconSize-bredden, som hämtar standardsystemstorleken för ikonen. Den anslutna egenskapen IsHitTestVisibleInChrome anges på bilden så att den kan ta emot mushändelser.

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