DTE2.ActiveWindow - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает активное в данный момент окно или верхнее окно, если другие окна неактивны.

Пространство имен: EnvDTE80
Сборка: EnvDTE80 (в EnvDTE80.dll)

Синтаксис

'Декларация
ReadOnly Property ActiveWindow As Window
'Применение
Dim instance As DTE2
Dim value As Window

value = instance.ActiveWindow

Window ActiveWindow { get; }

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

function get ActiveWindow () : Window

Значение свойства

Тип: EnvDTE.Window
Объект Window. Возвращает значение Nothing, если открытых окон нет.

Реализации

_DTE.ActiveWindow

Заметки

ActiveWindow возвращает активное окно среды.

Задать заголовки можно только для окон инструментов. При попытке установить заголовок для окна другого типа, например, окна документа, возникает ошибка "Неопознанная ошибка".

Примеры

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);
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.