ToolWindows - интерфейс

Статья
08/11/2011

Облегчает поиск и использование инструментальных окон в рамках объектной модели путем предоставления удобного доступа к инструментальным окнам оболочки посредством собственных типов.

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

Синтаксис

'Декларация
<GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")> _
Public Interface ToolWindows

[GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")]
public interface ToolWindows

[GuidAttribute(L"19AC6F68-3019-4D65-8D98-404DFB96B8E2")]
public interface class ToolWindows

[<GuidAttribute("19AC6F68-3019-4D65-8D98-404DFB96B8E2")>]
type ToolWindows =  interface end

public interface ToolWindows

Тип ToolWindows предоставляет следующие члены.

Свойства

	Имя	Описание
	CommandWindow	Возвращает объект CommandWindow.
	DTE	Возвращает объект расширения верхнего уровня.
	ErrorList	Возвращает список ошибок, отображаемых в интегрированной среде разработки.
	OutputWindow	Возвращает объект OutputWindow.
	SolutionExplorer	Возвращает объект UIHierarchy, представляющий окно Обозреватель решений.
	TaskList	Возвращает объект TaskList.
	ToolBox	Возвращает объект ToolBox.

В начало страницы

Методы

	Имя	Описание
	GetToolWindow	Позволяет пользователю извлекать окно по его заголовку.

В начало страницы

Заметки

Доступ к инструментальным окнам Visual Studio может осуществляться посредством свойств членов. Для нахождения других инструментальных окон может использоваться функция GetToolWindow.

Примеры

В следующем примере добавляется Окно выходных данных с заголовком "My output", которое затем активируется и используется для вывода всех инструментальных окон, доступ к которым можно получить посредством объекта Collection родительского объекта ToolWindows. Дополнительные сведения о запуске этого примера как надстройки см. в разделе Практическое руководство. Компиляция и выполнение примеров кода модели объектов автоматизации.

Imports EnvDTE
Imports EnvDTE80
Public Sub OnConnection(ByVal application As Object, _
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection
    _applicationObject = CType(application, DTE2)
    _addInInstance = CType(addInInst, AddIn)
    OutputToolWindow(_applicationObject)
End Sub
Public Sub OutputToolWindow(ByVal dte As DTE2)
    Dim myOut As OutputWindow
    myOut = _applicationObject.ToolWindows.OutputWindow
    Dim myPane As OutputWindowPane
    Dim txt As String
    txt = ""
    MsgBox("Creating an output window.")
    myPane = myOut.OutputWindowPanes.Add("My output")
    myPane.Activate()
    MsgBox("Adding some text to the output window...")
    myPane.OutputString("This is the collection of tool windows, _
 reached through the Output Window object:" & vbCr)
    For Each tempWindow As EnvDTE80.Window2 In myOut.Parent.Collection
        txt = txt & (tempWindow.Caption & vbCr)
    Next tempWindow
    MsgBox("Displaying all the tool window captions _
 in the Output window...")
    myPane.OutputString(txt)
End Sub

using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
public void OnConnection(object application, 
ext_ConnectMode connectMode, object addInInst, ref Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    OutputToolWindow(_applicationObject);
}
public void OutputToolWindow(DTE2 dte)
{
    OutputWindow myOut;
    myOut = _applicationObject.ToolWindows.OutputWindow;
    OutputWindowPane myPane;
    String txt = null;
    MessageBox.Show("Creating an output window.");
    myPane = myOut.OutputWindowPanes.Add("My output");
    myPane.Activate();
    MessageBox.Show("Adding some text to the output window...");
    myPane.OutputString("This is the collection of tool
 windows,reached through the Output Window object:" + "\n");
    foreach (EnvDTE80.Window2 tempWindow in myOut.Parent.Collection)
    {
        txt = txt + (tempWindow.Caption + "\n");
    }
    MessageBox.Show("Displaying all the tool window captions 
in the output window...");
    myPane.OutputString(txt);
}

См. также

Ссылки

EnvDTE80 - пространство имен

Поделиться через