Partage via


Window Classe

Définition

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

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.IsBackgroundTransparentObtient 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.

S’applique à

Voir aussi