Propriedade _DTE.ActiveWindow

Artigo
08/01/2011

Retorna a janela ativa no momento ou a janela de nível mais alto, se não há outras pessoas estão ativos.

Namespace: EnvDTE
Assembly: EnvDTE (em EnvDTE.dll)

Sintaxe

'Declaração
ReadOnly Property ActiveWindow As Window
    Get

Window ActiveWindow { get; }

property Window^ ActiveWindow {
    Window^ get ();
}

abstract ActiveWindow : Window

function get ActiveWindow () : Window

Valor de propriedade

Tipo: EnvDTE.Window
A Window objeto.Retorna Nothing se nenhuma janela estiver aberta.

Comentários

ActiveWindowRetorna a janela ativa do ambiente.

Você pode definir a legenda somente em janelas de ferramentas. Se você tentar definir a legenda em outros tipos de janela, como janelas de documento, você obtém o erro, "Erro não especificado".

Exemplos

Sub ActiveWindowExample(ByVal dte As DTE2)

    ' Create two text files.
    Dim doc1 As Document = _
        dte.ItemOperations.NewFile(, "Document1").Document
    dte.ItemOperations.NewFile(, "Document2")

    MsgBox("The active window is " & dte.ActiveWindow.Caption)

    If MsgBox("Activate Document1?", MsgBoxStyle.YesNo) = _
        MsgBoxResult.Yes Then
        doc1.Activate()
    End If

    MsgBox("The active window is " & dte.ActiveWindow.Caption)

End Sub

public void ActiveWindowExample(DTE2 dte)
{
    // Create two text files.
    Document doc1 = dte.ItemOperations.NewFile(@"General\Text File", 
        "Document1", Constants.vsViewKindPrimary).Document;
    dte.ItemOperations.NewFile(@"General\Text File", "Document2", 
        Constants.vsViewKindPrimary);

    MessageBox.Show("The active window is " + 
        dte.ActiveWindow.Caption);

    if (MessageBox.Show("Activate Document1?", "", 
        MessageBoxButtons.YesNo) == DialogResult.Yes)
        doc1.Activate();

    MessageBox.Show("The active window is " + 
        dte.ActiveWindow.Caption);
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.