Window Classe

Definição

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

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.IsBackgroundTransparentObté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.

Aplica-se a

Confira também