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

Статья
11/05/2008

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

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

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

Синтаксис

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

value = instance.ActiveWindow

Window ActiveWindow { get; }

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

function get ActiveWindow () : Window

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

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

Заметки

Свойство 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);
}

Разрешения

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