Partager via


ApplicationView Classe

Définition

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

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.

S’applique à

Voir aussi