精靈 .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 是您的系統登錄所指定的地區設定。
|
||
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>。
|
||
WIZARD_NAME |
指定精靈名稱。位於 .vsz 中,並由符號的其餘部分使用。 |
||
WIZARD_UI |
指定在 .vsz 檔案中。一個布林 (Boolean) 值,其指出精靈是否含有使用者介面。有使用者介面即指定 TRUE,沒有使用者介面則指定 FALSE。 |