Como obter ou definir a janela principal do aplicativo (WPF .NET)
Este artigo ensina como obter ou definir a janela principal do aplicativo para o Windows Presentation Foundation (WPF). O primeiro Window que é instanciado dentro de um aplicativo WPF é definido automaticamente como Application a janela principal do aplicativo. A janela principal é referenciada com a Application.MainWindow propriedade.
Na maioria das vezes, um modelo de projeto definirá o Application.StartupUri como um arquivo XAML em seu aplicativo, como _Window1.xaml_. Esta é a primeira janela instanciada e mostrada pelo seu aplicativo, e se torna a janela principal.
Dica
O comportamento padrão de um aplicativo é desligar quando a última janela é fechada. Esse comportamento é controlado pela Application.ShutdownMode propriedade. Em vez disso, você pode configurar o aplicativo para desligar se o MainWindow estiver fechado. Defina Application.ShutdownMode como OnMainWindowClose para 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. Esta propriedade é útil porque:
- É facilmente alterável para um arquivo XAML diferente em seu projeto.
- Instancia e exibe automaticamente a janela especificada.
- A janela especificada torna-se o 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.StartupUrio , você pode definir o como uma janela declarada Application.MainWindow por 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 e as propriedades, exibirá ambas as Application.StartupUriApplication.MainWindow 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 Usar o evento Startup para abrir uma janela.
Definir a janela principal no código
A primeira janela instanciada pelo seu aplicativo se torna 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 seu aplicativo nunca criou uma instância de uma janela, o código a seguir é 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 ao 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
Confira também
.NET Desktop feedback
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de