Window Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- 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.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. |