Windows.CreateToolWindow-Methode

Článek
08/23/2008

Aktualisiert: November 2007

Erstellt ein neues Toolfenster, das das angegebene Document-Objekt oder ActiveX-Steuerelement enthält.

Namespace: EnvDTE
Assembly: EnvDTE (in EnvDTE.dll)

Syntax

'Declaration
Function CreateToolWindow ( _
    AddInInst As AddIn, _
    ProgID As String, _
    Caption As String, _
    GuidPosition As String, _
    <OutAttribute> ByRef DocObj As Object _
) As Window
'Usage
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

Parameter

AddInInst
Typ: EnvDTE.AddIn

Erforderlich. Ein AddIn-Objekt, dessen Lebensdauer die Lebensdauer des Toolfensters bestimmt.

ProgID
Typ: System.String

Erforderlich. Die programmgesteuerte ID des Document-Objekts oder ActiveX-Steuerelements.

Caption
Typ: System.String

Erforderlich. Die Beschriftung für das neue Toolfenster.

GuidPosition
Typ: System.String

Erforderlich. Eine eindeutige ID für das neue Toolfenster, die als Index für Item verwendet werden kann.

DocObj
Typ: System.Object%

Erforderlich. Das Document-Objekt oder -Steuerelement, das im Toolfenster aufgenommen werden soll.

Rückgabewert

Typ: EnvDTE.Window

Ein Window-Objekt.

Hinweise

Beim Versuch, die Sichtbarkeitszustände, wie Höhe, Breite oder Position, des neuen Toolfensters vor dem Einblenden dieses Fensters zu ändern, erhalten Sie eine Fehlermeldung. Daher sollten Sie vor dem Versuch, diese Eigenschaften festzulegen, sicherstellen, dass das Fenster sichtbar ist.

Ein Beispiel für die Verwendung dieser Methode finden Sie im Beispiel ToolWindow auf der Webseite Visual Studio Automation Samples. Informationen zum Erstellen von ActiveX-Steuerelementen finden Sie unter Erstellen eines MFC-ActiveX-Steuerelements.

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Windows-Schnittstelle

Windows-Member

EnvDTE-Namespace

Sdílet prostřednictvím