AppWindow Classe

Definição

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

Comentários

Important

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 verificar 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 a personalização da barra de título para obter mais informações.

Propriedades

Nome Description
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.

PersistedStateId

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

PlacementRestorationBehavior

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

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

Nome Description
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, WindowId, DispatcherQueue)

Cria uma janela com estilos e propriedades conforme definido na janela especificada AppWindowPresenter, pai da janela especificada e associada ao especificado DispatcherQueue.

Create(AppWindowPresenter, WindowId)

Cria uma janela com estilos e propriedades conforme definido na janela especificada AppWindowPresenter e pai da janela especificada.

Create(AppWindowPresenter)

Cria uma janela com estilos e propriedades conforme definido no especificado AppWindowPresenter.

Destroy()

Tenta destruir a janela do aplicativo.

GetCurrentPlacement()

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

GetFromWindowId(WindowId)

Retorna o AppWindow com o especificado WindowId, se disponível. Retorna null se não WindowId for possível corresponder 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, DisplayArea)

Move a janela para o ponto especificado dentro da área de exibição especificada e a define como o tamanho especificado.

MoveAndResize(RectInt32)

Move a janela para o ponto especificado nas coordenadas da tela e a define para 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.

SaveCurrentPlacement()

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

SaveCurrentPlacementForAllPersistedStateIds()

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

SetCurrentPlacement(AppWindowPlacementDetails, Boolean)

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

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.

SetTaskbarIcon(IconId)

Define o ícone da barra de tarefas usando a ID do ícone especificado.

SetTaskbarIcon(String)

Define o ícone da barra de tarefas usando o caminho do ícone especificado.

SetTitleBarIcon(IconId)

Define o ícone da barra de título da janela usando a ID do ícone especificada.

SetTitleBarIcon(String)

Define o ícone da barra de título da janela usando o caminho do ícone especificado.

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

Nome Description
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.

Aplica-se a

Confira também