Interfejs kreatora (IDTWizard)

  • Artykuł

Zintegrowane środowisko projektowe (IDE) używa interfejsu IDTWizard do komunikowania się z kreatorami. Kreatorzy muszą zaimplementować ten interfejs, aby można go było zainstalować w środowisku IDE.

Metoda Execute jest jedyną metodą skojarzona z interfejsem IDTWizard . Kreatory implementują tę metodę, a środowisko IDE wywołuje metodę w interfejsie. W poniższym przykładzie przedstawiono podpis metody .

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

Mechanizm uruchamiania jest podobny zarówno dla kreatorów Nowy projekt , jak i Dodaj nowy element . Aby uruchomić dowolny z tych elementów, należy wywołać IDTWizard interfejs zdefiniowany w pliku Dteinternal.h. Jedyną różnicą jest zestaw parametrów kontekstowych i niestandardowych przekazywanych do interfejsu podczas wywoływanego interfejsu.

Poniższe informacje opisują IDTWizard interfejs, który kreatorzy muszą zaimplementować, aby działały w środowisku IDE programu Visual Studio. Środowisko IDE wywołuje metodę Execute w kreatorze, przekazując ją w następujący sposób:

  • Obiekt DTE

    Obiekt DTE jest katalogem głównym modelu automatyzacji.

  • Dojście do okna dialogowego, jak pokazano w segmencie kodu, hwndOwner ([in] long).

    Kreator używa tego hwndOwner jako elementu nadrzędnego dla okna dialogowego kreatora.

  • Parametry kontekstu przekazane do interfejsu jako wariant funkcji SAFEARRAY, jak pokazano w segmencie [in] SAFEARRAY (VARIANT)* ContextParamskodu .

    Parametry kontekstu zawierają tablicę wartości specyficznych dla rodzaju uruchamiania kreatora i bieżącego stanu projektu. Środowisko IDE przekazuje parametry kontekstu do kreatora. Aby uzyskać więcej informacji, zobacz Parametry kontekstu.

  • Parametry niestandardowe przekazywane do interfejsu jako wariant funkcji SAFEARRAY, jak pokazano w segmencie [in] SAFEARRAY (VARIANT)* CustomParamskodu .

    Parametry niestandardowe zawierają tablicę parametrów zdefiniowanych przez użytkownika. Plik vsz przekazuje parametry niestandardowe do środowiska IDE. Wartości są określane przez instrukcje Param= . Aby uzyskać więcej informacji, zobacz Parametry niestandardowe.

  • Zwracane wartości interfejsu to

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

Zobacz też