Sdílet prostřednictvím

Rozhraní průvodce (IDTWizard)

  • Článek

Integrované vývojové prostředí (IDE) používá IDTWizard rozhraní ke komunikaci s průvodci. Průvodci musí implementovat toto rozhraní, aby bylo možné je nainstalovat do integrovaného vývojového prostředí ( IDE).

Tato Execute metoda je jedinou metodou přidruženou k IDTWizard rozhraní. Průvodci implementují tuto metodu a integrované vývojové prostředí volá metodu v rozhraní. Následující příklad ukazuje podpis metody.

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

Spouštěcí mechanismus je podobný průvodcům Nový projekt i Přidat novou položku . Chcete-li spustit buď, zavoláte IDTWizard rozhraní definované v Dteinternal.h. Jediným rozdílem je sada kontextových a vlastních parametrů, které se předávají rozhraní při zavolání rozhraní.

Následující informace popisují IDTWizard rozhraní, které průvodci musí implementovat pro práci v integrovaném vývojovém prostředí sady Visual Studio. Integrované vývojové prostředí volá metodu Execute v průvodci a předává ji následujícím způsobem:

  • Objekt DTE

    Objekt DTE je kořenem modelu Automation.

  • Popisovač dialogového okna, jak je znázorněno v segmentu kódu, hwndOwner ([in] long).

    Tento průvodce používá hwndOwner jako nadřazený prvek dialogového okna průvodce.

  • Kontextové parametry předané rozhraní jako varianta SAFEARRAY, jak je znázorněno v segmentu kódu , [in] SAFEARRAY (VARIANT)* ContextParams.

    Kontextové parametry obsahují pole hodnot, které jsou specifické pro typ spuštění průvodce a aktuální stav projektu. Integrované vývojové prostředí předá průvodci kontextové parametry. Další informace naleznete v tématu Kontextové parametry.

  • Vlastní parametry předané rozhraní jako varianta SAFEARRAY, jak je znázorněno v segmentu kódu , [in] SAFEARRAY (VARIANT)* CustomParams.

    Vlastní parametry obsahují pole uživatelem definovaných parametrů. Soubor .vsz předává do integrovaného vývojového prostředí vlastní parametry. Hodnoty jsou určeny Param= příkazy. Další informace naleznete v tématu Vlastní parametry.

  • Návratové hodnoty rozhraní jsou

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

Viz také