AppWindow Classe

Definição

Namespace:

Microsoft.UI.Windowing

Representa um contêiner gerenciado pelo sistema para o conteúdo de um aplicativo.

public ref class AppWindow sealed

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

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

Public NotInheritable Class AppWindow

Herança

Object Platform::Object IInspectable AppWindow

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Comentários

Importante

As APIs de personalização da barra de título têm suporte parcial no Windows 10 desde SDK do Aplicativo Windows 1.2 e têm suporte total no Windows 11. Você deve marcar AppWindowTitleBar.IsCustomizationSupported em seu código antes de chamar essas APIs para garantir que seu aplicativo não falhe em outras versões do Windows. Consulte Personalização da barra de título para obter mais informações.

Propriedades

ClientSize	Obtém o tamanho atual da área de cliente da janela nas coordenadas do cliente Win32.
DispatcherQueue	Obtém a fila do dispatcher associada à janela do aplicativo.
Id	Obtém o identificador da janela do aplicativo.
IsShownInSwitchers	Obtém ou define um valor que indica se essa janela aparecerá em várias representações do sistema, como ALT+TAB e barra de tarefas.
IsVisible	Obtém um valor que indica se a janela é mostrada.
OwnerWindowId	Obtém o identificador do proprietário desta janela; ou 0 se não tiver propriedade.
Position	Obtém a posição atual da janela nas coordenadas da tela.
Presenter	Obtém o apresentador atualmente aplicado para a janela do aplicativo.
Size	Obtém o tamanho atual da janela nas coordenadas da tela.
Title	Obtém ou define o título exibido da janela do aplicativo.
TitleBar	Obtém a barra de título da janela do aplicativo.

Métodos

AssociateWithDispatcherQueue(DispatcherQueue)	Associa a janela do aplicativo à fila do dispatcher especificada.
Create()	Cria uma janela do aplicativo com os estilos e propriedades definidos como o padrão OverlappedPresenter.
Create(AppWindowPresenter)	Cria uma janela com estilos e propriedades conforme definido no especificado AppWindowPresenter.
Create(AppWindowPresenter, WindowId)	Cria uma janela com estilos e propriedades conforme definido na janela especificada AppWindowPresenter e pai.
Create(AppWindowPresenter, WindowId, DispatcherQueue)	Cria uma janela com estilos e propriedades conforme definido no especificado AppWindowPresenter, pai para a janela especificada e associado ao especificado DispatcherQueue.
Destroy()	Tenta destruir a janela do aplicativo.
GetFromWindowId(WindowId)	Retorna o AppWindow com o especificado WindowId, se disponível. Retornará null se o WindowId não puder ser correspondido a uma janela válida.
Hide()	Oculta a janela de todas as representações de UX no sistema, mas mantém o objeto ativo.
Move(PointInt32)	Move a janela para o ponto especificado nas coordenadas da tela.
MoveAndResize(RectInt32)	Move a janela para o ponto especificado nas coordenadas da tela e a define para o tamanho especificado.
MoveAndResize(RectInt32, DisplayArea)	Move a janela para o ponto especificado dentro da área de exibição especificada e a define como o tamanho especificado.
MoveInZOrderAtBottom()	Move a janela atual para ser a janela inferior na ordem Z.
MoveInZOrderAtTop()	Move a janela atual para ser a janela superior na ordem Z.
MoveInZOrderBelow(WindowId)	Move a janela atual para estar abaixo da janela especificada na ordem Z.
Resize(SizeInt32)	Redimensiona a janela para o tamanho especificado.
ResizeClient(SizeInt32)	Redimensiona a janela para acomodar o tamanho especificado para a área do cliente.
SetIcon(IconId)	Define o ícone da janela usando a ID de ícone especificada.
SetIcon(String)	Define o ícone da janela usando o caminho de ícone especificado.
SetPresenter(AppWindowPresenter)	Aplica o apresentador especificado à janela.
SetPresenter(AppWindowPresenterKind)	Aplica o tipo de apresentador especificado à janela.
Show()	Mostra a janela e a ativa.
Show(Boolean)	Mostra a janela com uma opção para ativá-la ou não.
ShowOnceWithRequestedStartupState()	Mostra a janela com o apresentador padrão no estado solicitado.

Eventos

Changed	Ocorre quando uma propriedade da janela é alterada e o sistema está em um "estado estável" por enquanto.
Closing	Ocorre quando uma janela está sendo fechada por meio de uma acessibilidade do sistema.
Destroying	Ocorre quando uma janela está sendo destruída.

Confira também

• Gerenciar janelas do aplicativo
• Personalização da barra de título