Window Classe

Definição

/// [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 na Área de Trabalho em 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 SDK do Aplicativo Windows e está 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();
  }
}

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

Comentários

Para obter mais informações e exemplos, consulte a visão geral de janelas para WinUI e SDK do Aplicativo Windows.

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 de Microsoft Visual Studio, Window.Activate será incluído no App.xaml arquivo code-behind.

Você pode criar mais de um Window por thread em seus aplicativos. Veja Mostrar várias janelas para seu aplicativo.

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

Confira também

• IWindowNative
• Visão geral de janelas para WinUI e SDK do Aplicativo Windows
• Mostrar várias janelas para seu aplicativo
• Personalização da barra de título