Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Application.MainWindow propriété

 

Date de publication : novembre 2016

Obtient ou définit la fenêtre principale de l’application.

Espace de noms:   System.Windows
Assembly:  PresentationFramework (dans PresentationFramework.dll)

public Window MainWindow { get; set; }

Valeur de propriété

Type: System.Windows.Window

Un Window doit être désigné en tant que fenêtre d’application principale.

Exception Condition
InvalidOperationException

MainWindow est défini à partir d’une application est hébergée dans un navigateur, comme un applications du navigateur XAML (XBAP).

MainWindow est automatiquement définie avec une référence au premier Window objet à être instanciés dans le AppDomain.

Vous pouvez spécifier une fenêtre principale différente en définissant MainWindow assigne un autre Windows de l’objet à le MainWindow propriété.

Si le ShutdownMode propriété de le Application a l’objet OnMainWindowClose, fermer la fenêtre principale, l’application s’est arrêté.

Il est possible de définir la MainWindow propriété XAML, si la fenêtre principale d’une application n’est pas la fenêtre produite en définissant le StartupUri propriété dans XAML. Présente deux limitations les XAML approche sont :

  • Vous pouvez spécifier un XAML-uniquement Window ou un XAML-uniquement NavigationWindow en tant que la fenêtre principale.

  • Vous devez définir le Visibility propriété de la fenêtre que vous spécifiez, sinon il ne sera pas affichée.

La référence au premier Window objet à instancier est également ajoutée en tant que premier élément à le Windows collection. Si MainWindow est ensuite définie avec une référence à un autre Window, la position de l’élément avec la référence à la fenêtre principale change l’ordre des éléments dans Windows reste le même. Par conséquent, utilisez toujours MainWindow pour faire référence à la fenêtre principale au lieu du premier élément de Windows.

System_CAPS_noteRemarque

Si la fenêtre principale est un NavigationWindow, et vous devez avoir un accès spécifique à NavigationWindow membres, vous devrez effectuer un cast de la valeur de MainWindow à NavigationWindow.

Cette propriété est disponible uniquement dans le thread qui a créé le Application objet.

L’exemple suivant montre comment rechercher la fenêtre principale de l’application.

// Get the main window
Window mainWindow = this.MainWindow;

L’exemple suivant montre comment définir MainWindow à l’aide de XAML.

<Application 
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    StartupUri="StartupWindow.xaml"
    >
  <Application.MainWindow>
    <NavigationWindow Source="MainPage.xaml" Visibility="Visible"></NavigationWindow>
  </Application.MainWindow>
</Application>

L’exemple suivant montre comment instancier le MainWindow dans le code pendant le démarrage de l’application.

public partial class App : Application
{
    void App_Startup(object sender, StartupEventArgs e)
    {
        MainWindow window = new MainWindow();
        window.Show();
    }
}

.NET Framework
Disponible depuis 3.0
Silverlight
Disponible depuis 4.0
Retour au début
Afficher: