Método Windows2.CreateToolWindow (AddIn, String, String, String, Object%)

Artigo
10/26/2012

Cria uma nova janela de ferramenta contendo especificado Document objeto ou controle de ActiveX.

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: EnvDTE.AddIn
Obrigatório.Um AddIn objeto cujo tempo de vida determina o tempo de vida da janela de ferramenta.

ProgID
Tipo: System.String
Obrigatório.A identificação programática da Document objeto ou controle de ActiveX.

Caption
Tipo: System.String
Obrigatório.A legenda para a nova janela de ferramenta.

GuidPosition
Tipo: System.String
Obrigatório.Um identificador exclusivo para a nova janela de ferramenta e ele pode ser usado como um índice de Windows.Item.

DocObj
Tipo: System.Object%
Obrigatório.O Document objeto ou controle para hospedagem na janela da ferramenta.

Valor de retorno

Tipo: EnvDTE.Window
A Window object.

Comentários

Se você tentar definir estados de visibilidade da nova janela de ferramenta — como, por exemplo, altura, largura ou posição — antes que a janela de ferramentas estiver visível, você obterá um erro.Certifique-se de que a janela está visível antes de tentar definir quaisquer dessas propriedades.

Para obter um exemplo de como usar esse método, consulte o exemplo de ToolWindow sobre o Visual Studiopágina da Web de amostras de automação. Para obter informações sobre como criar controles de ActiveX, consulte Criar um controle de ActiveX do 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áveis.

Consulte também

Referência

Windows2 Interface

Sobrecargas CreateToolWindow

Namespace EnvDTE80

Compartilhar via