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

Comentários

A WindowChrome classe permite que você estenda o conteúdo do WPF (Windows Presentation Foundation) para a área não cliente de uma janela normalmente reservada para o gerenciador de janelas do sistema operacional.

Windows Padrão

As janelas padrão são compostas por dois retângulos sobrepostos. O retângulo externo é a área que não é cliente, que geralmente é conhecida como cromo. Ele é desenhado e gerenciado pelo gerenciador de janelas do sistema operacional. Suas dimensões são determinadas pelas configurações padrão do sistema operacional. O quadro não cliente fornece recursos e comportamentos de janela padrão. Eles incluem botões de legenda (Minimizar, Maximizar e Fechar), a borda da janela, redimensionar e mover comportamentos, o ícone e o título do aplicativo e o menu do sistema. O retângulo interno é a área do cliente. Ele contém o conteúdo do aplicativo e é desenhado e gerenciado pelo aplicativo. Para obter mais informações sobre janelas em aplicativos WPF, consulte a Visão geral do Windows do WPF.

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

Janelas personalizadas

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

WindowStyle.None

Uma maneira de personalizar a aparência de uma janela de aplicativo do WPF é definir a Window.WindowStyle propriedade como None. Isso remove o quadro não cliente da janela e deixa apenas a área do cliente, à qual você pode aplicar um estilo personalizado. No entanto, quando o quadro não cliente é removido, você também perde os recursos e comportamentos do sistema que ele fornece, como botões de legenda e redimensionamento de janela. Outro efeito colateral é que a janela cobrirá a barra de tarefas do Windows quando for maximizada. A configuração WindowStyle.None permite que você crie um aplicativo completamente personalizado, mas também exige que você implemente a lógica personalizada em seu aplicativo para emular o comportamento padrão da janela.

Windowchrome

Para personalizar uma janela mantendo sua funcionalidade padrão, você pode usar a WindowChrome classe. A WindowChrome classe separa a funcionalidade do quadro de janela dos visuais e permite controlar o limite entre as áreas cliente e não cliente da janela do aplicativo. A WindowChrome classe permite que você coloque o conteúdo do WPF no quadro da janela estendendo a área do cliente para cobrir a área não cliente. Ao mesmo tempo, ele retém os comportamentos do sistema por meio de duas áreas invisíveis; as áreas de borda e legenda de redimensionamento.

Há duas partes principais para criar uma janela personalizada usando a WindowChrome classe. Primeiro, você personaliza a parte não cliente da janela definindo as propriedades expostas no WindowChrome objeto. Em seguida, você fornece um modelo para a janela que define a parte do aplicativo que é estendida para a área não cliente. As propriedades expostas no WindowChrome objeto são ResizeBorderThickness, CaptionHeighte CornerRadiusGlassFrameThickness.

A ResizeBorderThickness propriedade especifica uma borda invisível ao redor do lado de fora da janela do aplicativo que o usuário pode clicar e arrastar para redimensionar a janela.

A CaptionHeight propriedade especifica uma área invisível na parte superior da janela que permite comportamentos do sistema normalmente associados à barra de título. Esses comportamentos incluem: clique e arraste para mover a janela, clique duas vezes para maximizar a janela e clique com o botão direito do mouse para mostrar o menu do sistema.

A borda de redimensionamento e a área de legenda não têm elementos visuais; elas definem apenas as áreas que respondem à entrada e habilitam comportamentos de janela padrão fornecidos pelo sistema.

A CornerRadius propriedade especifica a quantidade que os cantos da janela são arredondados. Essa propriedade não terá efeito se o quadro de vidro estiver habilitado para uma janela.

A GlassFrameThickness propriedade especifica a largura do quadro de vidro ao redor da janela. Por padrão, ele usa o valor do sistema especificado pela WindowNonClientFrameThickness propriedade para emular a aparência de uma janela padrão. Quando o quadro de vidro é usado, os botões de legenda para Minimizar, Maximizar e Fechar são visíveis e interativos. O aplicativo é responsável por exibir o ícone do aplicativo e o texto da legenda. Você pode definir a GlassFrameThickness propriedade para tornar o quadro de vidro mais largo ou mais estreito do que o padrão.

Para criar uma janela personalizada que não tenha uma estrutura de vidro, defina a GlassFrameThickness propriedade como um valor uniforme de 0. Isso desabilitará e ocultará os botões de legenda padrão.

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

Não há suporte para efeitos de vidro do Windows Aero em todos os sistemas operacionais e podem ser desabilitados em sistemas operacionais com suporte. Se o Windows Aero não estiver disponível, o quadro de vidro não será exibido independentemente do valor da GlassFrameThickness propriedade. Em vez disso, a área de borda especificada por essa propriedade será preta. Verifique a IsGlassEnabled propriedade para verificar se os efeitos de vidro do Windows Aero estão disponíveis. Se os efeitos de vidro não estiverem disponíveis, você deverá fornecer um estilo de janela alternativo que não use o quadro de vidro ou use a janela padrão definindo o estilo da janela como nulo.

Estenda o conteúdo do WPF para o quadro da janela especificando um ControlTemplate que define a aparência e o comportamento do conteúdo do quadro. Defina o TargetType do ControlTemplate como o tipo da janela que você está personalizando.

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

Por padrão, as partes de todos os elementos visuais que estão dentro da área não cliente da janela não são interativas. Para habilitar elementos interativos na área não cliente, anexe a propriedade anexada WindowsChrome.IsHitTestVisibleInChrome ao elemento e defina-a como true.

A marcação XAML a seguir 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 setter anexa o WindowChrome à janela. Ele usa todos os valores padrão para as propriedades WindowChrome, o que faz com que a janela pareça uma janela padrão.

<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 em seu aplicativo. Por padrão, a classe WindowChrome estende a área do cliente para cobrir a borda não cliente. Para descobrir o quadro de vidro, você precisa especificar uma margem em torno do ContentPresenter. Essa marcação especifica uma borda com um plano de fundo branco ao redor do apresentador de conteúdo para emular a aparência de uma janela padrão. Ele também especifica uma margem associada à propriedade WindowNonClientFrameThickness, que obtém a largura do sistema padrão para o quadro.

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

O ícone e o título do aplicativo não são exibidos pela classe WindowChrome; eles precisam ser adicionados à borda como conteúdo personalizado. O XAML a seguir adiciona uma imagem e um bloco de texto para exibir o ícone e o título. Ambos os elementos estão associados às propriedades correspondentes na janela. A largura da imagem está associada à largura SmallIconSize, que obtém o tamanho padrão do sistema para o ícone. A propriedade anexada IsHitTestVisibleInChrome é definida na imagem para que ela possa receber eventos do mouse.

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