Freigeben über

Assistentenschnittstelle (IDTWizard)

  • Artikel

Die integrierte Entwicklungsumgebung (Integrated Development Environment, IDE) verwendet die Schnittstelle für die IDTWizard Kommunikation mit Assistenten. Assistenten müssen diese Schnittstelle implementieren, um in der IDE installiert zu werden.

Die Execute Methode ist die einzige Methode, die der IDTWizard Schnittstelle zugeordnet ist. Assistenten implementieren diese Methode, und die IDE ruft die Methode auf der Schnittstelle auf. Das folgende Beispiel zeigt die Signatur der Methode.

/* IDTWizard Method */
STDMETHOD(Execute)(THIS_
   /* [in] */ IDispatch *Application,
   /* [in] */ long hwndOwner,
   /* [in] */ SAFEARRAY * *ContextParams,
   /* [in] */ SAFEARRAY * *CustomParams,
   /* [out] [in] */ wizardResult *RetVal
   );

Der Startmechanismus ist sowohl für die Assistenten "Neues Projekt " als auch für "Neues Element hinzufügen" ähnlich. Um entweder zu beginnen, rufen Sie die IDTWizard in Dteinternal.h definierte Schnittstelle auf. Der einzige Unterschied besteht aus dem Satz von Kontext- und benutzerdefinierten Parametern, die beim Aufrufen der Schnittstelle an die Schnittstelle übergeben werden.

Die folgenden Informationen beschreiben die IDTWizard Schnittstelle, die Assistenten implementieren müssen, um in der Visual Studio-IDE zu funktionieren. Die IDE ruft die Execute Methode für den Assistenten auf, und übergibt sie folgendes:

  • Das DTE-Objekt

    Das DTE-Objekt ist der Stamm des Automatisierungsmodells.

  • Das Handle zum Fensterdialogfeld, wie im Codesegment dargestellt. hwndOwner ([in] long)

    Der Assistent verwendet dies hwndOwner als übergeordnetes Element für das Dialogfeld des Assistenten.

  • Kontextparameter, die als Variante für SAFEARRAY an die Schnittstelle übergeben werden, wie im Codesegment dargestellt. [in] SAFEARRAY (VARIANT)* ContextParams

    Kontextparameter enthalten ein Array von Werten, die für die Art des gestarteten Assistenten und den aktuellen Status des Projekts spezifisch sind. Die IDE übergibt die Kontextparameter an den Assistenten. Weitere Informationen finden Sie unter Kontextparameter.

  • Benutzerdefinierte Parameter, die als Variante für SAFEARRAY an die Schnittstelle übergeben werden, wie im Codesegment dargestellt. [in] SAFEARRAY (VARIANT)* CustomParams

    Benutzerdefinierte Parameter enthalten ein Array von benutzerdefinierten Parametern. Eine VSZ-Datei übergibt benutzerdefinierte Parameter an die IDE. Die Werte werden durch die Param= Anweisungen bestimmt. Weitere Informationen finden Sie unter "Benutzerdefinierte Parameter".

  • Rückgabewerte für die Schnittstelle sind

    wizardResultSuccess = -1,
wizardResultFailure = 0
wizardResultCancel = 1
wizardResultBackout = 2

Siehe auch