精靈介面 (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