Window Classe

Definição

Namespace:

Windows.UI.Xaml

Representa uma janela do aplicativo.

public ref class Window sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class Window

Public NotInheritable Class Window

Herança

Object Platform::Object IInspectable Window

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo de código a seguir mostra a substituição do método OnLaunched gerada para o modelo de aplicativo em branco no Microsoft Visual Studio. Esse código demonstra padrões de uso típicos para as propriedades Current e Content e o método Activate .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Comentários

Essa classe representa a janela do Aplicativo atual. Da mesma maneira que a propriedade Application estática, a propriedade Current estática retornará o objeto da janela do aplicativo. Nesse objeto, um aplicativo pode utilizar o Dispatcher ou determinar o tamanho da Janela da propriedade Bounds . O uso mais comum para o Window é definir um UIElement como o Conteúdo que representa a interface do usuário do aplicativo. Isso geralmente é feito como parte da ativação do aplicativo (por exemplo, na substituição OnLaunched .) Você pode alterar o conteúdo dessa janela durante todo o tempo de vida da janela.

Não há representação XAML da classe Window porque ela não é um controle.

Um objeto Window está apenas exibindo informações do CoreWindow, que, por sua vez, está fazendo referência à janela criada pelo sistema.

Certifique-se de chamar Ativar em qualquer Janela que você usar na ativação inicial. Se você usar os modelos de aplicativo padrão do Microsoft Visual Studio, chamar Window.Activate faz parte do código inicial no arquivo code-behind app.xaml.

A classe LayoutAwarePage que faz parte de alguns modelos de aplicativo no Microsoft Visual Studio tem tratamento para o evento SizeChanged , que é usado para manter o controle dos estados visuais que correspondem aos valores de ApplicationViewState. LayoutAwarePage também tem código que verifica Limites e usa esse valor para influenciar como os eventos de entrada em toda a página são tratados.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	Compositor
1903	18362	UIContext

Membros de interface adicionais

IXamlSourceTransparency.IsBackgroundTransparent

Obtém ou define um valor que especifica se a tela de fundo de todos os objetos DesktopWindowXamlSource no thread atual é transparente.

Propriedades

Bounds	Obtém um valor rect que contém a origem, altura e largura da área do cliente da janela, em DIPs (pixels independentes do dispositivo).
Compositor	Obtém o Compositor desta janela.
Content	Obtém ou define a raiz visual de uma janela do aplicativo.
CoreWindow	Obtém um objeto principal interno para a janela do aplicativo.
Current	Obtém a janela do thread atual.
Dispatcher	Obtém o objeto CoreDispatcher para a Janela, que geralmente é o CoreDispatcher para o thread da interface do usuário.
UIContext	Obtém o identificador de contexto da janela.
Visible	Obtém um valor que relata se a janela está visível.

Métodos

Activate()	Tenta ativar a janela do aplicativo trazendo-a para o primeiro plano e definindo o foco de entrada para ela.
Close()	Fecha a janela do aplicativo.
SetTitleBar(UIElement)	Faz com que um elemento XAML interaja com o sistema como se fosse a barra de título.

Eventos

Activated	Ocorre quando a janela foi ativada com êxito.
Closed	Ocorre quando a janela é fechada.
SizeChanged	Ocorre quando a janela do aplicativo foi renderizada pela primeira vez ou alterou seu tamanho de renderização.
VisibilityChanged	Ocorre quando o valor da propriedade Visible é alterado.

Confira também

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Tratar a ativação do aplicativo