共用方式為


精靈介面 (IDTWizard)

整合式的開發環境 (IDE) 會使用IDTWizard與精靈通訊的介面。 若要安裝在 IDE 中,精靈必須實作這個介面。

Execute方法是與相關聯的唯一方法IDTWizard介面。 精靈會實作這個方法,IDE 會在介面上呼叫方法。 下列範例會示範方法的簽章。

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

開始機制都很相似新的專案加入新項目精靈。 若要啟動其中一個時,您呼叫IDTWizard Dteinternal.h 中所定義的介面。 唯一的差別在於顯示的內容及呼叫該介面時,會傳遞至介面的自訂參數。

下列資訊說明IDTWizard精靈必須在實作的介面Visual Studio IDE。 IDE 呼叫Execute在精靈中,將它傳遞下列方法:

  • DTE 物件

    DTE 物件是自動化模型的根。

  • [視窗] 對話方塊中的程式碼片段中所示的控制代碼hwndOwner ([in] long)。

    精靈會使用這hwndOwner為精靈] 對話方塊的父代。

  • 內容參數傳遞給介面,作為 variant 的安全陣列時發生如所示在程式碼片段中, [in] SAFEARRAY (VARIANT)* ContextParams。

    內容參數包含專用於啟動的精靈類型的值的陣列和專案的目前狀態。 IDE 會將內容參數傳遞給精靈。 如需詳細資訊,請參閱 內容參數

  • 自訂參數傳遞給介面,作為 variant 的安全陣列時發生如所示在程式碼片段中, [in] SAFEARRAY (VARIANT)* CustomParams。

    自訂參數會包含使用者定義的參數陣列。 .Vsz 檔案將自訂的參數傳遞至 IDE。 這些值由Param=陳述式。 如需詳細資訊,請參閱 自訂參數

  • 介面的傳回值

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

請參閱

概念

內容參數

自訂參數

精靈 (。Vsz) 檔案

其他資源

精靈