WindowChrome Classe

Definição

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

public class WindowChrome : System.Windows.Freezable

type WindowChrome = class
    inherit Freezable

Public Class WindowChrome
Inherits Freezable

Herança

Object

DispatcherObject

DependencyObject

Freezable

WindowChrome

Observações

A classe WindowChrome permite-lhe estender Windows Presentation Foundation conteúdo (WPF) para a área não cliente de uma janela, normalmente reservada para o gestor de janelas do sistema operativo.

Windows padrão

As janelas padrão são compostas por dois retângulos sobrepostos. O retângulo exterior é a área não-cliente, frequentemente referida como cromo. É desenhado e gerido pelo gestor de janelas do sistema operativo. As suas dimensões são determinadas pelas definições padrão do sistema operativo. O frame não-cliente fornece funcionalidades e comportamentos padrão da janela. Estas incluem botões de legenda (Minimizar, Maximizar e Fechar), a borda da janela, comportamentos de redimensionamento e movimento, o ícone e título da aplicação, e o menu do sistema. O retângulo interior é a área do cliente. Contém o conteúdo da sua candidatura, que é desenhada e gerida pela aplicação. Para mais informações sobre windows em aplicações WPF, consulte WPF Windows Visão Geral.

A ilustração seguinte mostra as partes de uma janela padrão.

Windows Personalizados

Podes personalizar a borda de uma janela definindo a Window.WindowStyle propriedade como None ou usando a WindowChrome classe.

WindowStyle.Nenhum

Uma forma de personalizar a aparência de uma janela de aplicação WPF é definir a propriedade Window.WindowStyle para None. Isto remove a moldura não-cliente da janela e deixa apenas a área do cliente, à qual pode aplicar um estilo personalizado. No entanto, quando o frame não-cliente é removido, também se perde as funcionalidades e comportamentos do sistema que ele proporciona, como botões de legenda e redimensionamento de janelas. Outro efeito secundário é que a janela cobre a barra de tarefas do Windows quando esta está maximizada. A definição WindowStyle.None permite-lhe criar uma aplicação completamente personalizada, mas também exige que implemente lógica personalizada na sua aplicação para emular o comportamento padrão das janelas.

WindowChrome

Para personalizar uma janela mantendo a sua funcionalidade padrão, pode usar a WindowChrome classe. A WindowChrome classe separa a funcionalidade da moldura da janela dos visuais e permite-lhe controlar a fronteira entre as áreas cliente e não cliente da sua janela de aplicação. A classe WindowChrome permite-lhe colocar WPF conteúdo na moldura da janela ao estender a área do cliente para cobrir a área não cliente. Ao mesmo tempo, mantém comportamentos do sistema através de duas áreas invisíveis; as áreas de redimensionamento da borda e legenda .

Existem duas partes principais para criar uma janela personalizada usando a WindowChrome classe. Primeiro, personaliza a parte não-cliente da janela definindo propriedades expostas no WindowChrome objeto. Depois fornece um modelo para a janela que define a parte da sua aplicação que está estendida para a área não cliente. As propriedades expostas no WindowChrome objeto são ResizeBorderThickness, CaptionHeight, CornerRadius, e GlassFrameThickness.

A ResizeBorderThickness propriedade especifica uma borda invisível em redor do exterior da janela da aplicação que o utilizador pode clicar e arrastar para redimensionar a janela.

A CaptionHeight propriedade especifica uma área invisível no topo da janela que permite comportamentos do sistema tipicamente associados à barra de título. Estes comportamentos incluem: clicar e arrastar para mover a janela, fazer duplo clique para maximizar a janela e clicar com o botão direito para mostrar o menu do sistema.

A borda de redimensionamento e a área da legenda não têm elementos visuais; Definem apenas áreas que respondem à entrada e permitem comportamentos padrão de janelas fornecidas pelo sistema.

A CornerRadius propriedade especifica a quantidade em que os cantos da janela são arredondados. Esta propriedade não tem qualquer efeito se a moldura de vidro estiver ativada para uma janela.

A GlassFrameThickness propriedade especifica a largura da moldura de vidro em redor da janela. Por defeito, utiliza o valor do sistema especificado pela WindowNonClientFrameThickness propriedade para emular a aparência de uma janela padrão. Quando a moldura de vidro é usada, os botões de legenda para Minimizar, Maximizar e Fechar são visíveis e interativos. A aplicação é responsável por exibir o ícone da aplicação e o texto da legenda. Podes definir a GlassFrameThickness propriedade para tornar a moldura de vidro mais larga ou mais estreita do que o padrão.

Para criar uma janela personalizada que não tenha uma moldura de vidro, defina a GlassFrameThickness propriedade para um valor uniforme de 0. Isto vai desativar e esconder os botões de legenda padrão.

Para estender a moldura de vidro para cobrir toda a janela, defina a GlassFrameThickness propriedade com valor negativo em qualquer lado. Quando a GlassFrameThickness propriedade é definida para um valor negativo para qualquer lado, o seu valor coagido será igual a GlassFrameCompleteThickness.

Os efeitos de vidro Windows Aero não são suportados em todos os sistemas operativos e podem ser desativados em sistemas operativos suportados. Se Windows Aero não estiver disponível, a moldura de vidro não será exibida independentemente do valor da propriedade GlassFrameThickness. A área da fronteira especificada por esta propriedade aparecerá a preto em vez disso. Verifique a propriedade IsGlassEnabled para garantir que Windows efeitos de vidro Aero estão disponíveis. Se os efeitos de vidro não estiverem disponíveis, deve fornecer um estilo alternativo de janela que não use a moldura de vidro ou usar a janela padrão definindo o estilo da janela como nulo.

Estende o seu conteúdo WPF para o frame da janela especificando um ControlTemplate que define a aparência e o comportamento do conteúdo do frame. Defines o TargetType do ControlTemplate para o tipo da janela que estás a personalizar.

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

Por defeito, as partes de quaisquer elementos visuais que estejam dentro da área não cliente da janela não são interativas. Para ativar elementos interativos na área não cliente, anexe a propriedade WindowsChrome.IsTestVisibleInChrome ao elemento e defina-a como true.

A marcação XAML seguinte mostra os principais elementos necessários para personalizar uma janela usando a 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>

O primeiro levantador prende o WindowChrome à janela. Usa todos os valores predefinidos das propriedades do WindowChrome, o que faz com que a janela pareça uma janela normal.

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

O modelo de janela deve especificar um apresentador de conteúdo para exibir o conteúdo da janela especificada na sua aplicação. Por defeito, a classe WindowChrome estende a área do cliente para cobrir a fronteira não-cliente. Para descobrir a moldura de vidro, é necessário especificar uma margem em torno do ContentPresenter. Esta marcação especifica uma borda com fundo branco em redor do apresentador de conteúdo para emular a aparência de uma janela padrão. Também especifica uma margem que está vinculada à propriedade WindowNonClientFrameThickness, que obtém a largura padrão do sistema para o frame.

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

O ícone e o título da aplicação não são apresentados pela classe WindowChrome; Têm de ser adicionadas à borda como conteúdo personalizado. O XAML seguinte adiciona uma imagem e um bloco de texto para mostrar o ícone e o título. Ambos os elementos estão ligados às propriedades correspondentes na janela. A largura da imagem está ligada à largura SmallIconSize, que obtém o tamanho padrão do sistema para o ícone. A propriedade associada IsHitTestVisibleInChrome está definida na imagem para que possa receber eventos do rato.

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