ApplicationView Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa la vista de aplicación activa y los estados y comportamientos asociados.
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- Herencia
- Atributos
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Comentarios
Una ventana (también denominada vista de aplicación) es la parte mostrada de una aplicación de Windows Runtime. En Windows, la pantalla de un usuario puede tener hasta 4 ventanas de ancho variable que se muestran simultáneamente. No se superponen, y sus bordes superior e inferior tocan los bordes superior e inferior de la pantalla. Puede haber áreas que no sean de ventana entre ventanas adyacentes.
La ventana no es lo mismo que la página actual de la aplicación. Es mejor pensar en el contenedor de las páginas; Puede usar la referencia de ventana en el programa para todas las páginas de la aplicación.
Cada ventana tiene un elemento CoreWindow correspondiente que representa el subproceso de procesamiento de la interfaz de usuario (incluidos los controladores de entrada principales y el distribuidor de eventos) de la ventana.
Puede usar las propiedades (o métodos, para JavaScript) de la ventana en la configuración de las páginas. Por ejemplo: la propiedad Orientation indica si la ventana es vertical o horizontal; para Windows, la propiedad AdjacentToLeftDisplayEdge indica si el borde izquierdo de la pantalla es el borde izquierdo de la ventana; y el método isFullScreen indica si la ventana usa toda la pantalla. Para obtener ejemplos de uso de estos métodos, consulte el ejemplo De vistas de aplicación .
Para obtener un objeto de este tipo, llame a ApplicationView.GetForCurrentView.
Nota
No utilice el valor devuelto en la propiedad ApplicationView.Value al crear un diseño de página. Este método está en desuso y es posible que no esté disponible en futuras versiones.
Historial de versiones
| Versión de Windows | Versión del SDK | Valor agregado |
|---|---|---|
| 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 |
Propiedades
| AdjacentToLeftDisplayEdge |
Obtiene un valor que indica si la ventana actual está cerca del borde izquierdo de la pantalla. |
| AdjacentToRightDisplayEdge |
Obtiene un valor que indica si la ventana actual está cerca del borde derecho de la pantalla. |
| DesiredBoundsMode |
Obtiene un valor que indica los límites usados por el marco para diseñar el contenido de la ventana (vista de la aplicación). |
| FullScreenSystemOverlayMode |
Obtiene o establece un valor que indica cómo responde una aplicación en modo de pantalla completa a las acciones de deslizar el borde. |
| Id |
Obtiene el identificador de la ventana (vista de la aplicación). |
| IsFullScreen |
Nota IsFullScreen puede modificarse o no estar disponible para las versiones después de Windows 10. En su lugar, use IsFullScreenMode. Obtiene un valor que indica si la ventana toca los lados izquierdo y derecho de la pantalla. |
| IsFullScreenMode |
Obtiene un valor que indica si la aplicación se ejecuta en modo de pantalla completa. |
| IsOnLockScreen |
Obtiene si la ventana (vista de la aplicación) está en la pantalla de bloqueo de Windows. |
| IsScreenCaptureEnabled |
Obtiene o establece si la captura de pantalla está habilitada para la ventana (vista de aplicación). |
| Orientation |
Obtiene la orientación actual (horizontal o vertical) de la ventana (vista de la aplicación) con respecto a la pantalla. |
| PersistedStateId |
Obtiene o establece una cadena que identifica esta vista para realizar el seguimiento y guardar el estado. |
| PreferredLaunchViewSize |
Obtiene o establece el tamaño con el que se inicia la aplicación cuando la propiedad ApplicationView.PreferredLaunchWindowingMode se establece en PreferredLaunchViewSize, excepto en los casos en los que el sistema administra directamente el tamaño de la ventana. |
| PreferredLaunchWindowingMode |
Obtiene o establece un valor que indica el modo de ventana con el que se inicia la aplicación. |
| SuppressSystemOverlays |
Nota SuppressSystemOverlays puede modificarse o no estar disponible para las versiones después de Windows 10. En su lugar, use TryEnterFullScreenMode y FullScreenSystemOverlayMode. Obtiene o establece un valor que indica si se deben mostrar o no superposiciones del sistema (como las aplicaciones de superposición o el volante suave). |
| TerminateAppOnFinalViewClose |
Indica si la aplicación finaliza cuando se cierra la última ventana. |
| Title |
Obtiene o establece el título mostrado de la ventana. |
| TitleBar |
Obtiene la barra de título de la aplicación. |
| UIContext |
Obtiene el identificador de contexto de la vista. |
| Value |
Nota Los métodos estáticos applicationView se pueden modificar o no estar disponibles para las versiones después de Windows 8.1. En su lugar, use ApplicationView.GetForCurrentView para obtener un objeto ApplicationView . Obtiene el estado de la ventana actual (vista de la aplicación). |
| ViewMode |
Obtiene el modo de vista de la aplicación para la vista actual. |
| VisibleBounds |
Obtiene la región visible de la ventana (vista de la aplicación). La región visible es la región no ocluida por chrome, como la barra de estado y la barra de la aplicación. |
| WindowingEnvironment |
Obtiene el entorno de ventana de la vista. |
Métodos
| ClearAllPersistedState() |
Borra las propiedades que el sistema ha guardado para cualquier vista PersistedStateId para la aplicación especificada. |
| ClearPersistedState(String) |
Borra las propiedades que el sistema ha guardado para la vista con el identificador especificado para la aplicación especificada. |
| ExitFullScreenMode() |
Quita la aplicación del modo de pantalla completa. |
| GetApplicationViewIdForWindow(ICoreWindow) |
Obtiene el identificador de ventana que corresponde a un coreWindow específico administrado por la aplicación. |
| GetDisplayRegions() |
Devuelve la colección de regiones de visualización disponibles para la vista. |
| GetForCurrentView() |
Obtiene la configuración de comportamiento y estado de vista de la aplicación activa. |
| IsViewModeSupported(ApplicationViewMode) |
Determina si se admite el modo de vista especificado en el dispositivo actual. |
| SetDesiredBoundsMode(ApplicationViewBoundsMode) |
Establece un valor que indica los límites usados por el marco para diseñar el contenido de la ventana (vista de la aplicación). |
| SetPreferredMinSize(Size) |
Establece el tamaño más pequeño, en píxeles efectivos, permitido para la ventana de la aplicación. |
| ShowStandardSystemOverlays() |
Muestra elementos de la interfaz de usuario del sistema, como la barra de título, en una aplicación de pantalla completa. |
| TryConsolidateAsync() |
Intenta ocultar la vista de la aplicación actual. Este método es un equivalente mediante programación a un usuario que cierra la aplicación. |
| TryEnterFullScreenMode() |
Intenta colocar la aplicación en modo de pantalla completa. |
| TryEnterViewModeAsync(ApplicationViewMode) |
Intenta cambiar la vista de la aplicación al modo de vista especificado. |
| TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences) |
Intenta cambiar la vista de la aplicación al modo de vista especificado mediante las opciones especificadas. |
| TryResizeView(Size) |
Intenta cambiar el tamaño de la vista al tamaño especificado en píxeles efectivos. |
| TryUnsnap() |
Nota TryUnsnap puede modificarse o no estar disponible para las versiones después de Windows 8.1. Las aplicaciones se pueden cambiar de tamaño continuamente, pero no se pueden ajustar, empezando por Windows 8.1. Además, los métodos estáticos applicationView se pueden modificar o no estar disponibles para las versiones después de Windows 8.1. Use ApplicationView.GetForCurrentView para obtener un objeto ApplicationView . Intenta anular el montón de una aplicación acoplada anteriormente. Esta llamada solo se realizará correctamente cuando la aplicación se ejecute en primer plano. |
| TryUnsnapToFullscreen() |
Intenta anular el montón de una aplicación acoplada anteriormente. |
Eventos
| Consolidated |
Se produce cuando la ventana se quita de la lista de aplicaciones usadas recientemente o si el usuario ejecuta un gesto de cierre en ella. |
| VisibleBoundsChanged |
Este evento se genera cuando cambia el valor de VisibleBounds , normalmente como resultado de la barra de estado, la barra de aplicación u otro cromo que se muestra u oculta. |