Partager via


Window Classe

Définition

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

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 à

Voir aussi