Windows.CreateToolWindow - метод

Статья
11/05/2008

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

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

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.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 Windows
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
Обязательный. Уникальный идентификатор для нового окна инструмента, который можно использовать как индекс для Item.

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

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

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

Заметки

Если установить любое из видимых состояний для нового окна инструмента (например высоту, ширину или расположение) до того, как окно инструмента станет видимым, то получится ошибка. Следовательно, убедитесь, что окно является видимым перед тем, как попытаетесь установить какие-либо его свойства.

Пример использования данного метода см. в образце ToolWindow на веб-странице Образцы автоматизации Visual Studio. Сведения о создании элементов ActiveX управления см. в разделе Создание элемента управления ActiveX MFC.

Разрешения

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

См. также

Ссылки

Windows Интерфейс

Windows - члены

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

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