Window Classe

Définition

Espace de noms:

Windows.UI.Xaml

Représente une fenêtre d’application.

public ref class Window 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 Window 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 Window

Public NotInheritable Class Window

Héritage

Object Platform::Object IInspectable Window

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)

Exemples

L’exemple de code suivant montre le remplacement de méthode OnLaunched généré pour le modèle d’application vide dans Microsoft Visual Studio. Ce code illustre les modèles d’utilisation classiques pour les propriétés Current et Content et la méthode Activate .

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    // Create a Frame to act navigation context and navigate to the first page
    var rootFrame = new Frame();
    rootFrame.Navigate(typeof(BlankPage));

    // Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame;
    Window.Current.Activate();
}

Protected Overrides Sub OnLaunched(args As 
    Windows.ApplicationModel.Activation.LaunchActivatedEventArgs)

    ' Create a Frame to act navigation context and navigate to the first page
    Dim rootFrame As New Frame()
    rootFrame.Navigate(GetType(BlankPage))

    ' Place the frame in the current Window and ensure that it is active
    Window.Current.Content = rootFrame
    Window.Current.Activate()
End Sub

Remarques

Cette classe représente la fenêtre de l’application actuelle. De la même manière que la propriété application statique, la propriété Current statique renvoie l’objet de fenêtre d’application. À partir de cet objet, une application peut utiliser le répartiteur ou déterminer la taille de la fenêtre à partir de la propriété Bounds . L’utilisation la plus courante pour Window consiste à définir un élément UIElement sur le contenu qui représente l’interface utilisateur de l’application. Cette opération est généralement effectuée dans le cadre de l’activation de l’application (par exemple dans le remplacement OnLaunched ).) Vous pouvez modifier ce contenu de fenêtre tout au long de la durée de vie de la fenêtre.

Il n’existe aucune représentation XAML de la classe Window, car il ne s’agit pas d’un contrôle.

Un objet Window fait simplement apparaître les informations de CoreWindow, qui à son tour fait référence à la fenêtre créée par le système.

Veillez à appeler Activer sur n’importe quelle fenêtre que vous utilisez lors de l’activation initiale. Si vous utilisez les modèles d’application par défaut de Microsoft Visual Studio, l’appel de Window.Activate fait partie du code initial dans le fichier code-behind app.xaml.

La classe LayoutAwarePage qui fait partie de certains modèles d’application dans Microsoft Visual Studio gère l’événement SizeChanged , qui est utilisé pour effectuer le suivi des états visuels qui correspondent aux valeurs d’ApplicationViewState. LayoutAwarePage a également du code qui vérifie les limites et utilise cette valeur pour influencer la façon dont les événements d’entrée à l’échelle de la page sont gérés.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1703	15063	Compositeur
1903	18362	UIContext

Membres d’interface supplémentaires

IXamlSourceTransparency.IsBackgroundTransparent

Obtient ou définit une valeur qui spécifie si l’arrière-plan de tous les objets DesktopWindowXamlSource sur le thread actuel est transparent.

Propriétés

Bounds	Obtient une valeur Rect qui contient l’origine, la hauteur et la largeur de la zone cliente de la fenêtre, en pixels indépendants de l’appareil (DIPs).
Compositor	Obtient le compositeur de cette fenêtre.
Content	Obtient ou définit la racine visuelle d’une fenêtre d’application.
CoreWindow	Obtient un objet principal interne pour la fenêtre d’application.
Current	Obtient la fenêtre du thread actuel.
Dispatcher	Obtient l’objet CoreDispatcher pour la fenêtre, qui est généralement le CoreDispatcher pour le thread d’interface utilisateur.
UIContext	Obtient l’identificateur de contexte pour la fenêtre.
Visible	Obtient une valeur qui indique si la fenêtre est visible.

Méthodes

Activate()	Tente d’activer la fenêtre d’application en la plaçant au premier plan et en lui affectant le focus d’entrée.
Close()	Ferme la fenêtre de l’application.
SetTitleBar(UIElement)	Fait qu’un élément XAML interagit avec le système comme s’il s’agit de la barre de titre.

Événements

Activated	Se produit lorsque la fenêtre a été correctement activée.
Closed	Se produit lorsque la fenêtre est fermée.
SizeChanged	Se produit lorsque la fenêtre d’application a été rendue pour la première fois ou que sa taille de rendu a changé.
VisibilityChanged	Se produit lorsque la valeur de la propriété Visible change.

Voir aussi

• OnLaunched(LaunchActivatedEventArgs)
• CoreWindow
• Gérer l’activation d’une application