Windows.CreateToolWindow (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Crea una nueva ventana de herramientas que contiene el objeto Document o el control ActiveX especificados.

Espacio de nombres: EnvDTE
Ensamblado: EnvDTE (en EnvDTE.dll)

Sintaxis

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

Parámetros

AddInInst
Tipo: EnvDTE.AddIn

Necesario. Un objeto AddIn cuya duración determina la duración de la ventana de herramientas.

ProgID
Tipo: System.String

Necesario. El Id. de programación del objeto Document o del control ActiveX.

Caption
Tipo: System.String

Necesario. El título de la nueva ventana de herramienta.

GuidPosition
Tipo: System.String

Necesario. Un identificador único para la nueva ventana de herramientas, que puede utilizarse como índice para Item.

DocObj
Tipo: System.Object%

Necesario. El objeto Document o el control que se va a alojar en la ventana de herramientas.

Valor devuelto

Tipo: EnvDTE.Window

Un objeto Window.

Comentarios

Si intenta establecer cualquiera de los estados de visibilidad de la nueva ventana de herramientas (como alto, ancho o posición) antes de que la ventana de herramientas sea visible, obtendrá un error. Por tanto, asegúrese de que la ventana sea visible antes de intentar establecer cualquiera de esas propiedades.

Para obtener un ejemplo de cómo utilizar este método, vea el ejemplo ToolWindow de la página web Visual Studio Automation Samples. Para obtener información acerca de cómo crear controles ActiveX, vea Crear un control ActiveX MFC.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

Windows (Interfaz)

Windows (Miembros)

EnvDTE (Espacio de nombres)

Share via