Window Classe

Référence

Définition

Espace de noms:: Microsoft.UI.Xaml

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.

Modifier

Représente la 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 in 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 chaque fenêtre explicitement. La création de plusieurs fenêtres nécessite la mise à jour 1.0.1 vers WindowsAppSDK 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();
  }
}

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

Remarques

Vous pouvez en créer plusieurs Window par thread dans vos applications. Consultez Créer une fenêtre dans exemples.

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

En règle générale, Window est utilisé pour définir un élément 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 le remplacement 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 quel Window élément utilisé lors de l’activation initiale. Si vous utilisez les modèles d’application par défaut de Microsoft Visual Studio, Window.Activate est inclus dans le fichier code-behind App.xaml.

Constructeurs

Window()

Initialise une nouvelle instance de la classe Window.

Propriétés

AppWindow	Obtient le `AppWindow` associé à ce XAML `Window`.
Bounds	Obtient une valeur Rect contenant la hauteur et la largeur de la fenêtre d’application en unités de pixels effectifs (affichage).
Compositor	Obtient le compositor pour cette fenêtre.
Content	Obtient ou définit la racine visuelle d’une fenêtre d’application.
CoreWindow	Les applications de bureau retournent `null` toujours pour cette propriété.
Current	Les applications de bureau retournent `null` toujours pour cette propriété.
Dispatcher	Retourne `null` toujours dans une application SDK d'application Windows. Notes `Window.Dispatcher` peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt Window.DispatcherQueue .
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 l’arrière-plan système à appliquer à ce `Window`. L’arrière-plan est affiché 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

Activate()	Tente d’activer la fenêtre d’application en la plaçant au premier plan et en lui définissant le focus d’entrée.
Close()	Ferme la fenêtre de l’application.
SetTitleBar(UIElement)	Active le comportement de la barre de titre sur un élément XAML quand `ExtendsContentIntoTitleBar` est `true`.

É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 a modifié sa taille de rendu.
VisibilityChanged	Se produit lorsque la valeur de la propriété Visible change.

S’applique à