ApplicationView Clase

Definición

Espacio de nombres:

Windows.UI.ViewManagement

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 ApplicationView

Public NotInheritable Class ApplicationView

Herencia

Object Platform::Object IInspectable ApplicationView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Consulte también

• Deshabilitación del ejemplo de captura de pantalla (Windows 10)
• Ejemplo de modo de interacción del usuario (Windows 10)
• Ejemplo de varias vistas (Windows 10)
• Ejemplo de modo de pantalla completa (Windows 10)
• Ejemplo de cambio de tamaño de ventana (Windows 10)
• Ejemplo de barra de título (Windows 10)