Compartilhar via

Como obter ou definir a janela principal do aplicativo

Este artigo ensina como obter ou definir a janela principal do aplicativo para o WPF (Windows Presentation Foundation). O primeiro Window que é instanciado em um aplicativo WPF é definido Application automaticamente como a janela principal do aplicativo. A janela principal é referenciada com a Application.MainWindow propriedade.

Na maior parte do tempo, um modelo de projeto definirá como Application.StartupUri um arquivo XAML em seu aplicativo, como _Window1.xaml_. Essa é a primeira janela instanciada e mostrada pelo aplicativo e se torna a janela principal.

Dica

O comportamento padrão de um aplicativo é desligar quando a última janela for fechada. Esse comportamento é controlado pela Application.ShutdownMode propriedade. Em vez disso, você pode configurar o aplicativo para desligar se MainWindow estiver fechado. Defina Application.ShutdownMode para OnMainWindowClose habilitar esse comportamento.

Definir a janela principal em XAML

Os modelos que geram seu aplicativo WPF normalmente definem a Application.StartupUri propriedade como um arquivo XAML. Essa propriedade é útil porque:

  1. Ele é facilmente mutável para um arquivo XAML diferente em seu projeto.
  2. Cria uma instância e exibe automaticamente a janela especificada.
  3. A janela especificada torna-se a Application.MainWindow.
<Application x:Class="MainApp.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:MainApp"
             StartupUri="Window1.xaml">
    
</Application>

Em vez de usar Application.StartupUri, você pode definir o Application.MainWindow para uma janela declarada em XAML. No entanto, a janela especificada aqui não será exibida e você deve definir sua visibilidade.

<Application x:Class="MainApp.App"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:local="clr-namespace:MainApp">

    <Application.MainWindow>
        <local:Window2 Visibility="Visible" />
    </Application.MainWindow>
</Application>

Cuidado

Se você definir as propriedades Application.StartupUri e Application.MainWindow, exibirá as duas janelas quando o aplicativo for iniciado.

Além disso, você pode usar o Application.Startup evento para abrir uma janela. Para obter mais informações, consulte Use o evento de inicialização para abrir uma janela.

Definir a janela principal no código

A primeira janela instanciada pelo aplicativo torna-se automaticamente a janela principal e é definida como a Application.MainWindow propriedade. Para definir uma janela principal diferente, altere essa propriedade para uma janela:

Application.Current.MainWindow = new Window2();

Application.Current.MainWindow.Show();

Application.Current.MainWindow = New Window2()

Application.Current.MainWindow.Show()

Se o aplicativo nunca tiver criado uma instância de uma janela, o código a seguir será funcionalmente equivalente ao código anterior:

var appWindow = new Window2();

appWindow.Show();

Dim appWindow As New Window2()

appWindow.Show()

Assim que a instância do objeto de janela é criada, ela é atribuída a Application.MainWindow.

Obter a janela principal

Você pode acessar a janela escolhida como a janela principal inspecionando a Application.MainWindow propriedade. O código a seguir exibe uma caixa de mensagem com o título da janela principal quando um botão é clicado:

private void Button_Click(object sender, RoutedEventArgs e) =>
    MessageBox.Show($"The main window's title is: {Application.Current.MainWindow.Title}");

Private Sub Button_Click(sender As Object, e As RoutedEventArgs)
    MessageBox.Show($"The main window's title is: {Application.Current.MainWindow.Title}")
End Sub

Consulte também