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

Статья
08/11/2011

Создает новое окно инструмента, содержащее указанный объект 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

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
)

abstract CreateToolWindow : 
        AddInInst:AddIn * 
        ProgID:string * 
        Caption:string * 
        GuidPosition:string * 
        DocObj:Object byref -> Window

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%)

Заметки

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

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

Windows2 Интерфейс

CreateToolWindow - перегрузка

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

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