Window Classe

Definição

Namespace:

Microsoft.UI.Xaml

Representa a janela do Aplicativo atual.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window

Public Class Window

Herança

Object IInspectable Window

Atributos

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemplos

OnLaunched

O exemplo de código a seguir mostra a substituição do método OnLaunched gerada para o modelo WinUI in Desktop no Microsoft Visual Studio. Esse código demonstra o uso típico do método Activate em Window.

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

Criar uma nova janela

Em seus aplicativos, você pode criar cada Janela explicitamente. A criação de mais de uma Janela requer a atualização 1.0.1 para o WindowsAppSDK e é limitada a um único thread.

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

Você também pode definir uma nova Janela na marcação:

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

com code-behind correspondente:

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
var window = new MainWindow();
window.Activate();

Comentários

Você pode criar mais de um Window por thread em seus aplicativos. Confira Criar uma nova janela em Exemplos.

Window implementa IWindowNative para habilitar a interoperabilidade por meio do HWND da Janela (WindowHandle).

Normalmente, Window é usado para definir um UIElement para 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 ) e permite que você altere o conteúdo da janela durante todo o tempo de vida da janela.

Certifique-se de chamar Ativar em qualquer Window usado na ativação inicial. Se você usar os modelos de aplicativo padrão do Microsoft Visual Studio, Window.Activate será incluído no arquivo code-behind App.xaml.

Construtores

Window()

Inicializa uma nova instância da classe Window .

Propriedades

AppWindow	Obtém o AppWindow associado a esse XAML Window.
Bounds	Obtém um valor rect que contém a altura e a largura da janela do aplicativo em unidades de pixels efetivos (exibição).
Compositor	Obtém o Compositor desta janela.
Content	Obtém ou define a raiz visual de uma janela do aplicativo.
CoreWindow	Os aplicativos da área de trabalho sempre retornam null para essa propriedade.
Current	Os aplicativos da área de trabalho sempre retornam null para essa propriedade.
Dispatcher	Sempre retorna null em um aplicativo SDK do Aplicativo Windows. Observação Window.Dispatcher pode ser alterado ou indisponível em versões futuras. Em vez disso , use Window.DispatcherQueue .
DispatcherQueue	Obtém o DispatcherQueue objeto da janela.
ExtendsContentIntoTitleBar	Obtém ou define um valor que especifica se a barra de título padrão da janela deve estar oculta para criar espaço para o conteúdo do aplicativo.
SystemBackdrop	Obtém ou define o pano de fundo do sistema a ser aplicado a este Window. O pano de fundo é renderizado por trás do Window conteúdo.
Title	Obtém ou define uma cadeia de caracteres usada para o título 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)	Habilita o comportamento da barra de título em um elemento XAML quando ExtendsContentIntoTitleBar é true.

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

• IWindowNative
• Tratar a ativação do aplicativo
• CoreWindow
• CoreApplicationView
• ApplicationView