Window Classe

Définition

Espace de noms:

Microsoft.UI.Xaml

Représente une fenêtre de l’application active.

/// [Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Window

[Microsoft.UI.Xaml.Markup.ContentProperty(Name="Content")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Window

Public Class Window

Héritage

Object IInspectable Window

Attributs

ContentPropertyAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

OnLaunched

L’exemple de code suivant montre le remplacement de méthode OnLaunched généré pour le modèle WinUI dans Desktop dans Microsoft Visual Studio. Ce code illustre l’utilisation classique de la méthode Activate sur Window.

protected override void OnLaunched(Microsoft.UI.Xaml.LaunchActivatedEventArgs args)
{
    m_window = new MainWindow();
    m_window.Activate();
}

private Window m_window;

Créer une fenêtre

Dans vos applications, vous pouvez créer explicitement chaque fenêtre. La création de plusieurs fenêtres nécessite la mise à jour 1.0.1 pour SDK d'application Windows et est limitée à un seul thread.

var window = new Window();
window.Content = new TextBlock() { Text = "Hello" };
window.Activate();

Vous pouvez également définir une nouvelle fenêtre dans le balisage :

<Window 
    x:Class="MainWindow"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <TextBlock>Hello</TextBlock>
</Window>

avec code-behind correspondant :

public partial class MainWindow : Window
{
  public MainWindow()
  {
    InitializeComponent();
  }
}

...
MainWindow window = new MainWindow();
window.Activate();

Remarques

Pour plus d’informations et d’exemples, consultez la vue d’ensemble du fenêtrage pour WinUI et SDK d'application Windows.

En règle générale, Window il est utilisé pour définir un UIElement sur le contenu qui représente l’interface utilisateur de l’application. Cela est généralement effectué dans le cadre de l’activation de l’application (par exemple, dans la substitution OnLaunched ) et vous permet de modifier le contenu de la fenêtre tout au long de la durée de vie de la fenêtre.

Veillez à appeler Activate sur n’importe quelle Window activation initiale utilisée. Si vous utilisez les modèles d’application par défaut de Microsoft Visual Studio, Window.Activate est inclus dans le App.xaml fichier code-behind.

Vous pouvez créer plusieurs Window threads par thread dans vos applications. Voir Afficher plusieurs fenêtres pour votre application.

Window implémente IWindowNative pour activer l’interopérabilité via le HWND de la fenêtre (WindowHandle).

Constructeurs

Nom	Description
Window()	Initialise une nouvelle instance de la classe Window .

Propriétés

Nom	Description
AppWindow	Obtient l’associé AppWindow à ce code XAML Window.
Bounds	Obtient une valeur Rect qui contient la hauteur et la largeur de la fenêtre d’application en unités de pixels effectifs (affichage).
Compositor	Obtient le compositeur pour cette fenêtre.
Content	Obtient ou définit la racine visuelle d’une fenêtre d’application.
CoreWindow	[Déconseillé] nullRetourne toujours .
Current	Retourne toujours null.
Dispatcher	[Déconseillé] nullRetourne toujours .
DispatcherQueue	Obtient l’objet DispatcherQueue de la fenêtre.
ExtendsContentIntoTitleBar	Obtient ou définit une valeur qui spécifie si la barre de titre par défaut de la fenêtre doit être masquée pour créer de l’espace pour le contenu de l’application.
SystemBackdrop	Obtient ou définit la toile de fond du système à appliquer à ce Windowparamètre . La toile de fond est rendue derrière le Window contenu.
Title	Obtient ou définit une chaîne utilisée pour le titre de la fenêtre.
Visible	Obtient une valeur qui indique si la fenêtre est visible.

Méthodes

Nom	Description
Activate()	Tente d’activer la fenêtre d’application en l’apportant au premier plan et en lui définissant le focus d’entrée.
Close()	Ferme (détruit) la fenêtre d’application.
SetTitleBar(UIElement)	Active le comportement de la barre de titre sur un élément XAML lorsque c’est truele casExtendsContentIntoTitleBar.

Événements

Nom	Description
Activated	Se produit lorsque la fenêtre a été correctement activée ou désactivée.
Closed	Se produit lorsque la fenêtre est fermée.
SizeChanged	Se produit lorsque la taille de rendu de la fenêtre a changé.
VisibilityChanged	Se produit lorsque la valeur de la propriété Visible change.

Voir aussi

• IWindowNative
• Vue d’ensemble des fenêtres pour WinUI et SDK d'application Windows
• Afficher plusieurs fenêtres pour votre application
• Personnalisation de la barre de titre