Window Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml
Editar

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.

Aplica-se a

Confira também