ApplicationView Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ApplicationViewPublic NotInheritable Class ApplicationView- Herança
- 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. |