ApplicationView Classe

Definição

Namespace:

Windows.UI.ViewManagement

Representa o modo de exibição de aplicativo ativo e os estados e comportamentos associados.

public ref class ApplicationView sealed

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

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

Public NotInheritable Class ApplicationView

Herança

Object Platform::Object IInspectable ApplicationView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Uma janela (também chamada de exibição de aplicativo) é a parte exibida de um aplicativo Windows Runtime. No Windows, a tela de um usuário pode ter até 4 janelas de largura variável exibidas simultaneamente. Eles não se sobrepõem e suas bordas superior e inferior tocam nas bordas superior e inferior da tela. Pode haver áreas que não sejam de janela entre janelas adjacentes.

A janela não é a mesma coisa que a página atual do aplicativo. É melhor pensar como o contêiner das páginas; você pode usar a referência de janela em seu programa para todas as páginas do aplicativo.

Cada janela tem um CoreWindow correspondente que representa o thread de processamento da interface do usuário (incluindo os principais manipuladores de entrada e o dispatcher de eventos) para a janela.

Você pode usar as propriedades (ou métodos, para JavaScript) da janela na configuração de suas páginas. Por exemplo: a propriedade Orientation informa se a janela é retrato ou paisagem; para Windows, a propriedade AdjacentToLeftDisplayEdge informa se a borda esquerda da tela é a borda esquerda da janela; e o método isFullScreen informa se a janela usa a tela inteira. Para obter exemplos de como usar esses métodos, consulte o exemplo exibições de aplicativo .

Para obter um objeto desse tipo, chame ApplicationView.GetForCurrentView.

Observação

Não use o valor retornado na propriedade ApplicationView.Value ao criar um layout de página. Esse método foi preterido e pode não estar disponível em versões futuras.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	IsViewModeSupported
1703	15063	TryConsolidateAsync
1703	15063	TryEnterViewModeAsync(ApplicationViewMode)
1703	15063	TryEnterViewModeAsync(ApplicationViewMode,ViewModePreferences)
1703	15063	Viewmode
1903	18362	ClearAllPersistedState
1903	18362	ClearPersistedState
1903	18362	GetDisplayRegions
1903	18362	PersistedStateId
1903	18362	UIContext
1903	18362	WindowingEnvironment

Propriedades

AdjacentToLeftDisplayEdge	Obtém um valor que indica se a janela atual está próxima da borda esquerda da tela.
AdjacentToRightDisplayEdge	Obtém um valor que indica se a janela atual está próxima da borda direita da tela.
DesiredBoundsMode	Obtém um valor que indica os limites usados pela estrutura para definir o conteúdo da janela (exibição de aplicativo).
FullScreenSystemOverlayMode	Obtém ou define um valor que indica como um aplicativo no modo de tela inteira responde às ações de passar o dedo de borda.
Id	Obtém a ID da janela (exibição de aplicativo).
IsFullScreen	Observação IsFullScreen pode ser alterado ou indisponível para versões após Windows 10. Em vez disso, use IsFullScreenMode. Obtém um valor que indica se a janela toca nos lados esquerdo e direito da exibição.
IsFullScreenMode	Obtém um valor que indica se o aplicativo está em execução no modo de tela inteira.
IsOnLockScreen	Obtém se a janela (exibição de aplicativo) está na tela de bloqueio do Windows.
IsScreenCaptureEnabled	Obtém ou define se a captura de tela está habilitada para a janela (exibição de aplicativo).
Orientation	Obtém a orientação atual (paisagem ou retrato) da janela (exibição de aplicativo) em relação à exibição.
PersistedStateId	Obtém ou define uma cadeia de caracteres que identifica essa exibição para acompanhar e salvar o estado.
PreferredLaunchViewSize	Obtém ou define o tamanho com o qual o aplicativo é iniciado quando a propriedade ApplicationView.PreferredLaunchWindowingMode é definida como PreferredLaunchViewSize, exceto nos casos em que o sistema gerencia o tamanho da janela diretamente.
PreferredLaunchWindowingMode	Obtém ou define um valor que indica o modo de janela com o qual o aplicativo é iniciado.
SuppressSystemOverlays	Observação SuppressSystemOverlays pode ser alterado ou indisponível para versões após Windows 10. Em vez disso, use TryEnterFullScreenMode e FullScreenSystemOverlayMode. Obtém ou define um valor que indica se as sobreposições do sistema (como aplicativos de sobreposição ou o volante macio) devem ser mostradas.
TerminateAppOnFinalViewClose	Indica se o aplicativo é encerrado quando a última janela é fechada.
Title	Obtém ou define o título exibido da janela.
TitleBar	Obtém a barra de título do aplicativo.
UIContext	Obtém o identificador de contexto para a exibição.
Value	Observação Os métodos estáticos applicationView podem ser alterados ou indisponíveis para versões após Windows 8.1. Em vez disso, use ApplicationView.GetForCurrentView para obter um objeto ApplicationView . Obtém o estado da janela atual (exibição de aplicativo).
ViewMode	Obtém o modo de exibição do aplicativo para a exibição atual.
VisibleBounds	Obtém a região visível da janela (exibição de aplicativo). A região visível é a região não ocluída pelo cromo, como a barra de status e a barra de aplicativos.
WindowingEnvironment	Obtém o ambiente de janela para o modo de exibição.

Métodos

ClearAllPersistedState()	Limpa todas as propriedades que o sistema salvou para qualquer exibição PersistedStateId para o aplicativo especificado.
ClearPersistedState(String)	Limpa todas as propriedades que o sistema salvou para a exibição com o identificador especificado para o aplicativo especificado.
ExitFullScreenMode()	Tira o aplicativo do modo de tela inteira.
GetApplicationViewIdForWindow(ICoreWindow)	Obtém a ID da janela que corresponde a um CoreWindow específico gerenciado pelo aplicativo.
GetDisplayRegions()	Retorna a coleção de regiões de exibição disponíveis para a exibição.
GetForCurrentView()	Obtém o estado de exibição e as configurações de comportamento do aplicativo ativo.
IsViewModeSupported(ApplicationViewMode)	Determina se o modo de exibição especificado tem suporte no dispositivo atual.
SetDesiredBoundsMode(ApplicationViewBoundsMode)	Define um valor que indica os limites usados pela estrutura para definir o conteúdo da janela (exibição de aplicativo).
SetPreferredMinSize(Size)	Define o menor tamanho, em pixels efetivos, permitido para a janela do aplicativo.
ShowStandardSystemOverlays()	Mostra elementos da interface do usuário do sistema, como a barra de título, em um aplicativo de tela inteira.
TryConsolidateAsync()	Tenta ocultar a exibição do aplicativo atual. Esse método é um equivalente programático a um usuário que fecha o aplicativo.
TryEnterFullScreenMode()	Tenta colocar o aplicativo no modo de tela inteira.
TryEnterViewModeAsync(ApplicationViewMode)	Tenta alterar a exibição do aplicativo para o modo de exibição especificado.
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	Tenta alterar a exibição do aplicativo para o modo de exibição especificado usando as opções especificadas.
TryResizeView(Size)	Tenta alterar o tamanho da exibição para o tamanho especificado em pixels efetivos.
TryUnsnap()	Observação TryUnsnap pode estar alterado ou indisponível para versões após Windows 8.1. Os aplicativos podem ser redimensionados continuamente, mas não podem ser ajustados, começando em Windows 8.1. Além disso, os métodos estáticos do ApplicationView podem ser alterados ou indisponíveis para versões após Windows 8.1. Use ApplicationView.GetForCurrentView para obter um objeto ApplicationView . Tenta desacompactar um aplicativo anteriormente ajustado. Essa chamada só terá êxito quando o aplicativo estiver em execução em primeiro plano.
TryUnsnapToFullscreen()	Tenta desacompactar um aplicativo anteriormente ajustado.

Eventos

Consolidated	Ocorre quando a janela é removida da lista de aplicativos usados recentemente ou se o usuário executa um gesto de fechamento nela.
VisibleBoundsChanged	Esse evento é gerado quando o valor de VisibleBounds é alterado, normalmente como resultado da barra de status, barra de aplicativos ou outro cromo sendo mostrado ou oculto.

Confira também

• Desabilitando o exemplo de captura de tela (Windows 10)
• Amostra do modo de interação do usuário (Windows 10)
• Exemplo de várias exibições (Windows 10)
• Amostra de modo de tela inteira (Windows 10)
• Amostra de redimensionamento de janela (Windows 10)
• Exemplo de barra de título (Windows 10)