Windows2.CreateToolWindow - метод (AddIn, String, String, String, Object%)

Статья
11/05/2008

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

Создает новое окно инструмента, содержащее указанный объект Document или элемент управления ActiveX.

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

Синтаксис

'Декларация
Function CreateToolWindow ( _
    AddInInst As AddIn, _
    ProgID As String, _
    Caption As String, _
    GuidPosition As String, _
    <OutAttribute> ByRef DocObj As Object _
) As Window
'Применение
Dim instance As Windows2
Dim AddInInst As AddIn
Dim ProgID As String
Dim Caption As String
Dim GuidPosition As String
Dim DocObj As Object
Dim returnValue As Window

returnValue = instance.CreateToolWindow(AddInInst, _
    ProgID, Caption, GuidPosition, DocObj)

Window CreateToolWindow(
    AddIn AddInInst,
    string ProgID,
    string Caption,
    string GuidPosition,
    out Object DocObj
)

Window^ CreateToolWindow(
    [InAttribute] AddIn^ AddInInst, 
    [InAttribute] String^ ProgID, 
    [InAttribute] String^ Caption, 
    [InAttribute] String^ GuidPosition, 
    [InAttribute] [OutAttribute] Object^% DocObj
)

function CreateToolWindow(
    AddInInst : AddIn, 
    ProgID : String, 
    Caption : String, 
    GuidPosition : String, 
    DocObj : Object
) : Window

Параметры

AddInInst
Тип: EnvDTE.AddIn
Обязательно. Объект AddIn, время жизни которого определяет время жизни окна инструмента.

ProgID
Тип: System.String
Обязательно. Программный идентификатор объекта Document или элемента управления ActiveX.

Caption
Тип: System.String
Обязательно. Заголовок для нового окна инструмента.

GuidPosition
Тип: System.String
Обязательно. Уникальный идентификатор для нового окна инструмента, который можно использовать как индекс для Windows.Item.

DocObj
Тип: System.Object%
Обязательно. Объект Document или элемент управления, который следует разместить в окне инструмента.

Возвращаемое значение

Тип: EnvDTE.Window
Объект Window.

Реализации

Windows.CreateToolWindow(AddIn, String, String, String, Object%)

Заметки

При попытке установить видимые состояния для нового окна инструмента — например, высоту, ширину или расположение — до того, как окно инструмента станет видимым, произойдет ошибка. Убедитесь, что окно является видимым перед тем, как пытаться установить какие-либо его свойства.

Пример использования этого метода см. в примере ToolWindow на веб-странице "Образцы автоматизации Visual Studio" (Visual Studio Automation Samples): https://www.microsoft.com/downloads/details.aspx?familyid=3ff9c915-30e5-430e-95b3-621dccd25150&displaylang=en. Сведения о создании элементов ActiveX управления см. в разделе Создание элемента управления ActiveX MFC.

Разрешения

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