AppWindow Classe

  • Referência

Definição

Namespace:
Windows.UI.WindowManagement
Editar

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

public ref class AppWindow sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [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(Windows.Foundation.UniversalApiContract), 524288)]
[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

Requisitos do Windows

Família de dispositivos
Windows 10, version 1903 (introduzida na 10.0.18362.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v8.0)

Comentários

Observação

AppWindow está atualmente em versão prévia. Isso significa que você pode enviar aplicativos que usam o AppWindow à Store, mas alguns componentes de plataforma e estrutura são conhecidos por não funcionar com o AppWindow (confira Limitações).

Um AppWindow pode ser usado para representar uma parte exibida de um aplicativo Windows Runtime quando ele tiver mais de uma janela. É semelhante em conceito a uma ApplicationView, mas não tem o mesmo comportamento e tempo de vida.

Ao contrário de ApplicationView, cada AppWindow não tem um CoreWindow correspondente. Todos eles compartilham o mesmo thread de processamento de interface do usuário (incluindo o dispatcher de eventos) do qual foram criados.

Para obter um objeto desse tipo, chame AppWindow.TryCreateAsync.

Para conectar o conteúdo ao AppWindow, chame ElementCompositionPreview.SetAppWindowContent.

Você só pode conectar conteúdo XAML à sua AppWindow, não há suporte para conteúdo nativo do DirectX ou do Holographic.

Para especificar um tamanho mínimo preferencial para a janela do aplicativo, use o método WindowManagementPreview.SetPreferredMinSize .

Dica

Para obter mais informações e código demonstrando o AppWindow, consulte Mostrar várias exibições para um aplicativo e Mostrar várias exibições com AppWindow.

Um exemplo que mostra como usar a API AppWindow pode ser encontrado no repositório Exemplos Universais do Windows no GitHub em Exemplos/AppWindow.

Limitações

As limitações na versão prévia atual do AppWindow incluem (esta é uma lista não exaustiva):

  • Qualquer API que usa o padrão GetForCurrentView não está funcionando para AppWindow, pois CurrentView refere-se ao ApplicationView, que é uma entidade separada do AppWindow.
  • A reprodução de mídia de tela inteira não está disponível em MediaElement ou MediaPlayerElement.
  • MessageDialog não será modal para a janela correta, a recomendação é usar ContentDialog .
  • O WebView não tem suporte total. Você pode usar um WebView in-proc, mas qualquer coisa fora do conteúdo HTML estático pode ou não funcionar corretamente.
  • Se você definir a propriedade Window.Current.Content em XAML, ela destruirá todo o conteúdo XAML em seu AppWindow. Evite usar isso como um padrão para redefinir seu conteúdo ao suspender seu aplicativo se você usar AppWindow.
  • O Redimensionamento de Janela Suave não está funcionando para AppWindows. O quadro e o conteúdo serão redimensionados de forma independente, o que pode parecer não polido quando o layout de conteúdo estiver lento.
  • DisplayInformation não está acessível para AppWindow. Se o AppWindow estiver em um monitor diferente do ApplicationView, você não poderá consultar as informações de exibição corretas.
  • UserInteractionMode não pode ser definido para um AppWindow.
  • As caixas de diálogo de impressão (2D e 3D) não serão pai da janela correta.
  • AppWindow não pode detectar quando gestos de borda estão sendo invocados.
  • AppWindow não pode ser usado para atender a uma solicitação de ativação por meio de ActivationViewSwitcher.

Propriedades

Content

Obtém o conteúdo do aplicativo anexado atualmente à janela.
DispatcherQueue

Obtém a fila do dispatcher para a janela do aplicativo.
Frame

Obtém o quadro da janela do aplicativo.
IsVisible

Obtém um valor que indica se a janela pode ser vista em uma exibição.
PersistedStateId

Obtém ou define uma cadeia de caracteres que identifica essa janela para acompanhar e salvar o estado.
Presenter

Obtém o apresentador da janela do aplicativo.
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.
UIContext

Obtém o contexto da interface do usuário para a janela do aplicativo.
WindowingEnvironment

Obtém o ambiente de janela para a janela do aplicativo.

Métodos

ClearAllPersistedState()

Limpa todas as propriedades que o sistema salvou para qualquer janela PersistedStateId para o aplicativo especificado.
ClearPersistedState(String)

Limpa todas as propriedades que o sistema salvou para a janela com a ID especificada para o aplicativo especificado.
CloseAsync()

Fecha a janela do aplicativo.
GetDisplayRegions()

Retorna a coleção de regiões de exibição disponíveis para a janela do aplicativo.
GetPlacement()

Retorna um objeto de posicionamento que descreve a região de exibição, o deslocamento e o tamanho da janela do aplicativo.
RequestMoveAdjacentToCurrentView()

Faz uma solicitação para posicionar a janela ao lado do modo de exibição atual.
RequestMoveAdjacentToWindow(AppWindow)

Faz uma solicitação para posicionar a janela ao lado da janela de âncora especificada.
RequestMoveRelativeToCurrentViewContent(Point)

Faz uma solicitação para posicionar a janela no deslocamento especificado em relação à exibição atual.
RequestMoveRelativeToDisplayRegion(DisplayRegion, Point)

Faz uma solicitação para posicionar a janela na região de exibição especificada no deslocamento especificado.
RequestMoveRelativeToWindowContent(AppWindow, Point)

Faz uma solicitação para posicionar a janela no deslocamento especificado em relação à janela de âncora.
RequestMoveToDisplayRegion(DisplayRegion)

Faz uma solicitação para posicionar a janela na região de exibição especificada.
RequestSize(Size)

Faz uma solicitação para definir a janela para o tamanho especificado.
TryCreateAsync()

Tenta criar de forma assíncrona uma nova instância do AppWindow.
TryShowAsync()

Tenta mostrar assíncronamente a janela do aplicativo atual.

Eventos

Changed

Ocorre quando uma propriedade da janela do aplicativo é alterada.
Closed

Ocorre quando a janela do aplicativo foi fechada.
CloseRequested

Ocorre depois que a janela começa a ser fechada, mas antes de ser fechada e antes que o evento Fechado ocorra.

Aplica-se a