Partilhar via


ApplicationView Classe

Definição

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

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.

Aplica-se a

Confira também