ApplicationView Classe

Définition

Espace de noms:

Windows.UI.ViewManagement

Représente la vue d’application active et les états et comportements associés.

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

Héritage

Object Platform::Object IInspectable ApplicationView

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Une fenêtre (également appelée vue d’application) est la partie affichée d’une application Windows Runtime. Sur Windows, l’écran d’un utilisateur peut afficher simultanément jusqu’à 4 fenêtres de largeur variable. Ils ne se chevauchent pas, et leurs bords supérieurs et inférieurs touchent les bords supérieurs et inférieurs de l’écran. Il peut y avoir des zones non-fenêtres entre les fenêtres adjacentes.

La fenêtre n’est pas la même chose que la page active de l’application. Il est mieux considéré comme le conteneur des pages ; vous pouvez utiliser la référence de fenêtre dans votre programme pour toutes les pages de l’application.

Chaque fenêtre a un CoreWindow correspondant qui représente le thread de traitement de l’interface utilisateur (y compris les gestionnaires d’entrée principaux et le répartiteur d’événements) pour la fenêtre.

Vous pouvez utiliser les propriétés (ou méthodes, pour JavaScript) de la fenêtre lors de la configuration de vos pages. Par exemple : la propriété Orientation vous indique si la fenêtre est portrait ou paysage ; pour Windows, la propriété AdjacentToLeftDisplayEdge vous indique si le bord gauche de l’écran est la bordure gauche de la fenêtre ; et la méthode isFullScreen vous indique si la fenêtre utilise l’écran entier. Pour obtenir des exemples d’utilisation de ces méthodes, consultez l’exemple Vues d’application .

Pour obtenir un objet de ce type, appelez ApplicationView.GetForCurrentView.

Notes

N’utilisez pas la valeur retournée dans la propriété ApplicationView.Value lors de la création d’une mise en page. Cette méthode est déconseillée et peut ne pas être disponible dans les versions ultérieures.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
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

Propriétés

AdjacentToLeftDisplayEdge	Obtient une valeur qui indique si la fenêtre active se trouve à proximité du bord gauche de l’écran.
AdjacentToRightDisplayEdge	Obtient une valeur qui indique si la fenêtre active se trouve à proximité du bord droit de l’écran.
DesiredBoundsMode	Obtient une valeur qui indique les limites utilisées par l’infrastructure pour disposer le contenu de la fenêtre (vue d’application).
FullScreenSystemOverlayMode	Obtient ou définit une valeur qui indique comment une application en mode plein écran répond aux actions de balayage de bord.
Id	Obtient l’ID de la fenêtre (vue application).
IsFullScreen	Notes IsFullScreen peut être modifié ou indisponible pour les versions après Windows 10. Utilisez plutôt IsFullScreenMode. Obtient une valeur qui indique si la fenêtre touche les côtés gauche et droit de l’affichage.
IsFullScreenMode	Obtient une valeur qui indique si l’application s’exécute en mode plein écran.
IsOnLockScreen	Obtient si la fenêtre (vue d’application) se trouve sur l’écran de verrouillage De Windows.
IsScreenCaptureEnabled	Obtient ou définit si la capture d’écran est activée pour la fenêtre (vue d’application).
Orientation	Obtient l’orientation actuelle (paysage ou portrait) de la fenêtre (vue d’application) par rapport à l’affichage.
PersistedStateId	Obtient ou définit une chaîne qui identifie cette vue pour le suivi et l’enregistrement de l’état.
PreferredLaunchViewSize	Obtient ou définit la taille avec laquelle l’application démarre lorsque la propriété ApplicationView.PreferredLaunchWindowingMode est définie sur PreferredLaunchViewSize, sauf dans les cas où le système gère directement la taille de la fenêtre.
PreferredLaunchWindowingMode	Obtient ou définit une valeur qui indique le mode de fenêtrage avec lequel l’application démarre.
SuppressSystemOverlays	Notes SuppressSystemOverlays peut être modifié ou indisponible pour les mises en production après Windows 10. Utilisez plutôt TryEnterFullScreenMode et FullScreenSystemOverlayMode. Obtient ou définit une valeur indiquant si les superpositions système (telles que les applications de superposition ou le volant souple) doivent être affichées.
TerminateAppOnFinalViewClose	Indique si l’application s’arrête lorsque la dernière fenêtre est fermée.
Title	Obtient ou définit le titre affiché de la fenêtre.
TitleBar	Obtient la barre de titre de l’application.
UIContext	Obtient l’identificateur de contexte pour la vue.
Value	Notes Les méthodes statiques ApplicationView peuvent être modifiées ou indisponibles pour les mises en production après Windows 8.1. Utilisez plutôt ApplicationView.GetForCurrentView pour obtenir un objet ApplicationView . Obtient l’état de la fenêtre active (vue application).
ViewMode	Obtient le mode d’affichage de l’application pour l’affichage actuel.
VisibleBounds	Obtient la zone visible de la fenêtre (vue d’application). La région visible est la région qui n’est pas masquée par le chrome, comme la barre status et la barre de l’application.
WindowingEnvironment	Obtient l’environnement de fenêtrage de la vue.

Méthodes

ClearAllPersistedState()	Efface toutes les propriétés que le système a enregistrées pour n’importe quelle vue PersistedStateId pour l’application donnée.
ClearPersistedState(String)	Efface toutes les propriétés que le système a enregistrées pour la vue avec l’identificateur spécifié pour l’application donnée.
ExitFullScreenMode()	Sort l’application du mode plein écran.
GetApplicationViewIdForWindow(ICoreWindow)	Obtient l’ID de fenêtre qui correspond à un CoreWindow spécifique géré par l’application.
GetDisplayRegions()	Retourne la collection des régions d’affichage disponibles pour l’affichage.
GetForCurrentView()	Obtient l’état d’affichage et les paramètres de comportement de l’application active.
IsViewModeSupported(ApplicationViewMode)	Détermine si le mode d’affichage spécifié est pris en charge sur l’appareil actuel.
SetDesiredBoundsMode(ApplicationViewBoundsMode)	Définit une valeur indiquant les limites utilisées par l’infrastructure pour disposer le contenu de la fenêtre (vue d’application).
SetPreferredMinSize(Size)	Définit la plus petite taille, en pixels effectifs, autorisée pour la fenêtre d’application.
ShowStandardSystemOverlays()	Affiche les éléments de l’interface utilisateur système, comme la barre de titre, sur une application plein écran.
TryConsolidateAsync()	Tente de masquer l’affichage de l’application actuelle. Cette méthode est un équivalent programmatique à la fermeture de l’application par un utilisateur.
TryEnterFullScreenMode()	Tente de placer l’application en mode plein écran.
TryEnterViewModeAsync(ApplicationViewMode)	Tente de modifier l’affichage de l’application vers le mode d’affichage spécifié.
TryEnterViewModeAsync(ApplicationViewMode, ViewModePreferences)	Tente de modifier l’affichage de l’application vers le mode d’affichage spécifié à l’aide des options spécifiées.
TryResizeView(Size)	Tente de modifier la taille de l’affichage à la taille spécifiée en pixels effectifs.
TryUnsnap()	Notes TryUnsnap peut être modifié ou indisponible pour les versions après Windows 8.1. Les applications peuvent être redimensionnées en continu, mais ne peuvent pas être ancrées, à partir de Windows 8.1. En outre, les méthodes statiques ApplicationView peuvent être modifiées ou indisponibles pour les mises en production après Windows 8.1. Utilisez ApplicationView.GetForCurrentView pour obtenir un objet ApplicationView . Tente de détacher une application précédemment ancrée. Cet appel réussit uniquement lorsque l’application est en cours d’exécution au premier plan.
TryUnsnapToFullscreen()	Tente de détacher une application précédemment ancrée.

Événements

Consolidated	Se produit lorsque la fenêtre est supprimée de la liste des applications récemment utilisées, ou si l’utilisateur exécute un mouvement de fermeture dessus.
VisibleBoundsChanged	Cet événement est déclenché lorsque la valeur de VisibleBounds change, généralement en raison de l’affichage ou de la masquer de la barre d’status, de la barre de l’application ou d’un autre chrome.

Voir aussi

• Désactivation de l’exemple de capture d’écran (Windows 10)
• Exemple de mode d’interaction utilisateur (Windows 10)
• Exemple de vues multiples (Windows 10)
• Exemple de mode plein écran (Windows 10)
• Exemple de redimensionnement de fenêtre (Windows 10)
• Exemple de barre de titre (Windows 10)