共用方式為


精靈 .Vsz 檔案中的自訂參數

此 .vsz 檔案會在其前兩行中辨識精靈版本,和要共同建立的精靈之 ProgID 或 CLSID。此 .vsz 檔案也可以包含要加入至符號表 (連同 HTML 符號區段中提供的符號) 的選擇性內文參數和自訂參數。

Execute 方法會顯示精靈,而該精靈會將定義在 .vsz 檔案中的內容和自訂參數之陣列做為其參數。

下列常用的符號被指定為在 .vsz 檔案或 .htm 檔案中的自訂參數,並可用於精靈 HTML 檔案、指令碼檔或樣板檔案中。

範例

如下列 .vsz 檔案項目指示,名為 MyProjWiz 的精靈包含了一個使用者介面。

VSWIZARD 7.0
Wizard=VsWizard.VsWizardEngine
Param="WIZARD_NAME = MyProjWiz"
Param="WIZARD_UI = TRUE"

精靈 .vsz 檔案中的自訂精靈符號

符號

定義

ABSOLUTE_PATH

精靈檔案的位置。

HTML_FILTER

指定在 .vsz 檔案中。置於方案總管的 [HTML 檔案] 資料夾內的檔案類型。通常指定為「htm」。

HTML_PATH

指定在 .vsz 檔案中。精靈 HTML 檔案的位置。根據預設,它是 START_PATH\HTML\ LANGUAGE (其中 LANGUAGE 是您的系統登錄所指定的地區設定。

注意事項注意事項

您可將 <LangID> 設為 HKEY_CURRENT_USER\Software\Microsoft\VisualStudio\7.0\General\UILanguage 的十進位值,來指定不同的語言。如需詳細資訊,請參閱將精靈當地語系化為多種語言。如需十進位語言值清單的詳細資訊,請參閱其他語言的精靈支援

IMAGE_FILTER

指定在 .vsz 檔案中。置於 [方案總管] 的 [影像檔] 資料夾內的檔案類型。通常指定為「bmp;gif」。

IMAGES_PATH

指定在 .vsz 檔案中。html 檔案中使用的影像檔之位置。根據預設,其為 START_PATH\Images。

MISC_FILTER

指定在 .vsz 檔案中。置於 [方案總管] 中的 [雜項] 資料夾內的檔案類型。通常指定為 「vsz;vsdir;ico;vcproj;csproj;css;inf」。

PRODUCT

根據預設,設成 Visual C++;不過,您可將此值設成 Visual Basic 來建立 Visual Basic 精靈等等。

PRODUCT_INSTALLATION_DIR

列示於 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\7.0\Setup\<Product>\ ProductDir 登錄機碼的目錄。

PROJECT_TEMPLATE_NAME

指定在 .vsz 檔案中。精靈用來建立專案的專案樣板檔案。通常指定為「txt」。

PROJECT_TEMPLATE_PATH

這個目錄包含專案的樣板檔案。在 Visual C++ 中,其預設值為 PRODUCT_INSTALLATION_DIR\VCWizards。

RELATIVE_PATH

如果找不到 ABSOLUTE_PATH,則考慮 RELATIVE_PATH。這是相對於 PRODUCT_INSTALLATION_DIR 的路徑。在 Visual C++ 中,RELATIVE_PATH 為 PRODUCT_INSTALLATION_DIR\VCWizards。

SCRIPT_COMMON_PATH

相對於 PRODUCT_INSTALLATION_DIR 的目錄名稱,其中可找到通用指令碼檔。例如,在 Visual C++ 中,這是 VCWizards。

SCRIPT_FILTER

指定在 .vsz 檔案中。置於 [方案總管] 的 [指令碼檔] 資料夾內的檔案類型。通常指定為「js」(JScript) 或「vbs」(VBScript)。

SCRIPT_PATH

精靈 JScript 檔案的位置。根據預設,其為 START_PATH\Scripts

START_PATH

指定在 .vsz 檔案中。這不是由使用者所設定,而是在內部用來辨識 RELATIVE_PATH 或 ABSOLUTE_PATH。精靈名稱 (WIZARD_NAME) 會附加至這個值上。

TEMPLATE_FILTER

指定在 .vsz 檔案中。置於 [方案總管] 的 [樣板檔案] 資料夾內的檔案類型。通常指定為「txt」。

TEMPLATES_PATH

指定在 .vsz 檔案中。精靈樣板檔案的位置。根據預設,其為 START_PATH\Templates\<LangID>。

注意事項注意事項

如需 LangID 的詳細資訊,請參閱 HTML_PATH。

WIZARD_NAME

指定精靈名稱。位於 .vsz 中,並由符號的其餘部分使用。

WIZARD_UI

指定在 .vsz 檔案中。一個布林 (Boolean) 值,其指出精靈是否含有使用者介面。有使用者介面即指定 TRUE,沒有使用者介面則指定 FALSE

請參閱

工作

建立自訂精靈

參考

自訂精靈

Execute

概念

您的精靈所建立的檔案

設計精靈