自訂精靈
您必須在使用自訂精靈自訂您建立的精靈時,考量下列共同的工作。
在 .vsz 檔案中,指定任何讓精靈能作業的必要自訂參數。如需詳細資訊,請參閱 .vsz 檔案 (專案控制) 和預先定義的自訂精靈符號。
如果您將精靈當地語系化為數種不同的語言,請將該語言參數加入至 .vsz 檔案。如需詳細資訊,請參閱將精靈當地語系化為多種語言。
自訂樣板檔案 (和 Templates.inf) 來指定用於使用者選取的指示詞。
自訂 Default.js 檔來指定精靈的其他特殊處理方式。您可撰寫您自己的函式,也可以使用 Common.js 中提供的函式。
設計圖示以及您的 HTML 使用者介面要使用的其他影像。
設計 HTML 使用者介面。
將符號加入至 HTML 符號表,以符合您的精靈使用的按鈕、控制項、文字方塊和其他項目。
以下顯示自訂精靈所提供之 HTML 的摘錄:
<SYMBOL NAME="WIZARD_DIALOG_TITLE" TYPE=text VALUE="MyCustomWiz"> </SYMBOL> <SYMBOL NAME="SAMPLE_CHECKBOX" TYPE=checkbox VALUE=true> </SYMBOL>
這個名為 MyCustomWiz 的精靈顯示一個預設選取的核取方塊。
在 HTML 檔案中標示為 <SCRIPT LANGUAGE="JSCRIPT"> 的區段中,加入 JScript 函式呼叫,並存取 Visual Studio 物件模型來自訂精靈的行為。您必須依下列方式使用 window.external 來呼叫這些函式:
window.external.AddSymbol("MAIN_FRAME_DEFAULT_STYLES", true); window.external.AddSymbol("MAIN_FRAME_STYLE_FLAGS", "");
注意事項 透過 Visual Studio 的 Automation 和擴充性、Visual C++ 程式碼模型、專案模型和精靈模型公開的方法、屬性和事件,可以讓您在 JScript 檔和 .htm 檔中,以程式設計的方式管理精靈專案從建立到建置 (Build) 的所有層面。
必要時,請自訂 .vsdir 檔案,讓 Shell 能瞭解 .vsz 檔案和其他所有樣板的相關資訊。例如,指示圖示資源 ID、旗標、當地語系化名稱等等。
建立精靈必須當地語系化成之所有語言的 .htm 檔案和樣板檔案。將它們加入至適當的專案目錄。
提供精靈的顯示即時線上說明。