Compartir a través de


ApplicationView Clase

Definición

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

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.

Se aplica a

Consulte también