.vsz 檔案 (專案控制)
更新:2007 年 11 月
每一個精靈的起點都是 .vsz 檔案。.vsz 檔案是一個文字檔,其決定要呼叫的精靈以及要傳遞給精靈的資訊。這個檔案含有兩行標題,後接要傳遞給精靈的不同選擇性參數。如需選擇性參數的清單,請參閱預先定義的自訂精靈符號。
下列範例顯示 .vsz 檔案中的標題:
VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine.8.0
Param="WIZARD_NAME = My AppWizard"
標題的第一行會指定範本檔案格式的版本號碼。您可以將此號碼指定為 6.0、7.0 或 7.1。其他數字都無效,使用其他數字會造成「無效的格式」錯誤。
第二行將 Wizard 變數設定為由 Visual Studio 所共同建立之精靈的 ProgID。ProgID 是 CLSID 的字串表示,例如 VsWizard.VsWizardEngine.8.0。
如果您的精靈具有使用者介面,則此 ProgID 會自動指定精靈以實作 IVCWizCtlUI。根據預設,這個介面的方法是用於專案的 .htm 檔案。您可在 .htm 檔案中使用這個介面的方法,以變更精靈的行為。如需詳細資訊,請參閱 VCWizCtl,它是 IVCWizCtlUI 的 coclass。
在這兩行後面是一份選擇性參數清單,其可讓 .vsz 檔案傳遞其他自訂參數給精靈。每一個值都是以精靈控制項的 Execute 方法中不同變數陣列的字串元素方式傳遞。根據預設,具有使用者介面的精靈會產生下列預設參數:
Param="START_PATH = <path to the wizard>" Param="HTML_PATH = <path to the wizard's HTML file>" Param="TEMPLATES_PATH = <path to the wizard's template file>" Param="SCRIPT_PATH = <path to the wizard's script files>" Param="IMAGES_PATH = <path to the wizard's images>"
如果您的精靈沒有使用者介面,它便不會有 IMAGES_PATH 參數,而是包含下列參數:
Param="WIZARD_UI = FALSE" Param="SOURCE_FILTER = txt"
這個 .vsz 檔案可包含下列參數,這些參數可以指定可在 Common.js 檔中找到的函式:
Param="PREPROCESS_FUNCTION = CanAddATLClass" Param="PREPROCESS_FUNCTION = CanAddMFCClass" Param="PREPROCESS_FUNCTION = CanAddClass"
精靈會呼叫 CanAddATLClass、CanAddMFCClass 和 CanAddClass 等函式,來確認可使用 Visual C++ 程式碼模型。如果有一個函式傳回 false,精靈就不會啟動。
您可將精靈加入至 Visual Studio 中的新增專案對話方塊的 [樣板] 窗格中,方法為將 .vsz 檔案置於 vc7\vcprojects 目錄中。自訂精靈預設會將 .vsz 檔寫入這個目錄。
注意事項: |
---|
如果您刪除了精靈檔案和目錄,您便必須同時刪除該專案在 vc7\vcprojects 目錄中的 .vsz 檔、.vsdir 檔和 .ico 檔。 |
請參閱
工作
概念
使用 .Vsdir 檔案將精靈加入至加入項目和新增專案對話方塊