Método Windows2.CreateToolWindow

Artigo
05/17/2015

Cria uma nova janela da ferramenta que contém o objeto especificado ou o controle ActiveX de Document .

Namespace: EnvDTE80
Assembly: EnvDTE80 (em EnvDTE80.dll)

Sintaxe

'Declaração
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

Parâmetros

AddInInst
Tipo: AddIn

Necessário. Um objeto de AddIn cujo tempo de vida determina o tempo de vida da janela da ferramenta.

ProgID
Tipo: String

Necessário. Programático A ID do objeto ou do controle ActiveX Document .

Caption
Tipo: String

Necessário. A legenda da janela da ferramenta.

GuidPosition
Tipo: String

Necessário. Um identificador exclusivo para a janela da ferramenta, e podem ser usados como um índice a Windows.Item.

DocObj
Tipo: Object%

Necessário. O objeto ou o controle de Document a ser hospedados na janela da ferramenta.

Valor de retorno

Tipo: Window
Um objeto Window.

Comentários

Se você tentar definir o estado de visibilidade da janela da nova ferramenta como a altura, a largura, ou a posição — antes que a janela da ferramenta esteja visível, você obterá um erro. Certifique-se de que a janela é visível antes de tentar definir propriedades.

Para obter um exemplo de como usar esse método, consulte o exemplo de ToolWindow em Visual StudioA automação prova a página da Web. Para obter informações sobre como criar controles ActiveX, consulte Criando um controle ActiveX MFC.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

Windows2 Interface

Namespace EnvDTE80

Compartilhar via