Window.ShowActivated Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Obtém ou define um valor que indica se uma janela é ativada quando mostrada pela primeira vez.

public:
 property bool ShowActivated { bool get(); void set(bool value); };

public bool ShowActivated { get; set; }

member this.ShowActivated : bool with get, set

Public Property ShowActivated As Boolean

Valor da propriedade

Boolean

true se uma janela é ativada quando mostrada pela primeira vez; caso contrário, false. O padrão é true.

Exemplos

O exemplo a seguir mostra como usar a marcação para configurar uma janela a ser aberta sem ser ativada.

<Window
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    x:Class="WindowShowActivatedSnippets.AWindow"
    ShowActivated="False">

using System.Windows;

namespace WindowShowActivatedSnippets
{
    public partial class AWindow : Window
    {
        public AWindow()
        {
            InitializeComponent();
        }
    }
}

Imports System.Windows

Namespace WindowShowActivatedSnippets
    Partial Public Class AWindow
        Inherits Window
        Public Sub New()
            InitializeComponent()
        End Sub
    End Class
End Namespace

O exemplo a seguir mostra como usar o código para configurar uma janela a ser aberta sem que ela seja ativada.

AWindow window = new AWindow();
window.ShowActivated = false;
window.Show();

Dim window As New AWindow()
window.ShowActivated = False
window.Show()

Comentários

Quando uma janela com sua ShowActivated propriedade definida false como é aberta, a janela não é ativada e seu Activated evento não é acionado até que um usuário ative manualmente a janela selecionando-a. Depois que a janela é selecionada, ela é ativada e desativada normalmente.

Para impedir que uma janela seja ativada quando for aberta, a ShowActivated propriedade deve ser definida false como antes que a janela seja mostrada (chamando Show); a configuração ShowActivated como false depois que uma janela é mostrada não tem efeito.

Definir ShowActivated como false em uma janela que é aberta modally, chamando ShowDialog, não tem nenhum impacto real. Embora a janela modal não seja ativada, a janela modal impedirá que o usuário ative qualquer outra janela de aplicativo aberta.

Informações da propriedade de dependência

Campo Identificador	ShowActivatedProperty
Propriedades de metadados definidas como true	Nenhum