Sihirbaz Arabirimi (IDTWizard)

Tümleşik geliştirme ortamı (IDE), sihirbazlarla iletişim kurmak için arabirimini kullanır IDTWizard . Sihirbazların IDE'ye yüklenebilmesi için bu arabirimi uygulaması gerekir.

Execute yöntemi, arabirimle IDTWizard ilişkili tek yöntemdir. Sihirbazlar bu yöntemi uygular ve IDE arabiriminde yöntemini çağırır. Aşağıdaki örnekte yönteminin imzası gösterilmektedir.

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

Başlangıç mekanizması hem Yeni Proje hem de Yeni Öğe Ekle sihirbazları için benzerdir. İki durumdan birini başlatmak için Dteinternal.h içinde tanımlanan arabirimi çağırırsınız IDTWizard . Tek fark, arabirim çağrıldığında arabirime geçirilen bağlam ve özel parametreler kümesidir.

Aşağıdaki bilgiler, sihirbazların IDTWizard Visual Studio IDE'de çalışmak için uygulaması gereken arabirimi açıklar. IDE, sihirbazda yöntemini çağırarak Execute aşağıdakini geçirir:

  • DTE nesnesi

    DTE nesnesi Otomasyon modelinin köküdür.

  • Kod kesiminde gösterildiği gibi pencere iletişim kutusunun tutamacı. hwndOwner ([in] long)

    Sihirbaz bunu hwndOwner sihirbaz iletişim kutusunun üst öğesi olarak kullanır.

  • Kod kesiminde gösterildiği gibi, SAFEARRAY için değişken olarak arabirime geçirilen bağlam parametreleri. [in] SAFEARRAY (VARIANT)* ContextParams

    Bağlam parametreleri, başlatılan sihirbazın türüne ve projenin geçerli durumuna özgü bir değer dizisi içerir. IDE, bağlam parametrelerini sihirbaza geçirir. Daha fazla bilgi için bkz . Bağlam Parametreleri.

  • Kod kesiminde [in] SAFEARRAY (VARIANT)* CustomParamsgösterildiği gibi, SAFEARRAY için bir değişken olarak arabirime geçirilen özel parametreler.

    Özel parametreler, kullanıcı tanımlı bir parametre dizisi içerir. .vsz dosyası özel parametreleri IDE'ye geçirir. Değerler deyimleri tarafından Param= belirlenir. Daha fazla bilgi için bkz . Özel Parametreler.

  • Arabirimin dönüş değerleri şunlardır:

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

Ayrıca bkz.

  • Last updated on