Windows2.CreateToolWindow-Methode (AddIn, String, String, String, Object%)

Artikel
10/24/2012

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

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

Syntax

'Declaration
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

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 des 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 Windows.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

Wenn Sie versuchen, Sichtbarkeitszustände des neuen Toolfensters, wie Höhe, Breite oder Position, einzurichten, bevor das Toolfenster sichtbar ist, wird ein Fehler erzeugt.Stellen Sie sicher, dass das Fenster sichtbar ist, bevor Sie versuchen, solche Eigenschaften festzulegen.

Ein Beispiel für die Verwendung dieser Methode finden Sie im Beispiel zu Toolfenstern auf der Webseite für Visual Studio-Automatisierungsbeispiele.Informationen über dei Erstellung von ActiveX-Steuerelementen finden Sie unter Erstellen eines MFC-ActiveX-Steuerelements.

.NET Framework-Sicherheit

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

Windows2 Schnittstelle

CreateToolWindow-Überladung

EnvDTE80-Namespace

Freigeben über