共用方式為


自訂精靈

更新:2007 年 11 月

您必須在使用自訂精靈自訂您建立的精靈時,考量下列共同的工作。

  • 在 .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 檔案和樣板檔案。將它們加入至適當的專案目錄。

  • 提供精靈的顯示即時線上說明

請參閱

工作

建立自訂精靈

概念

設計精靈步驟

您的精靈所建立的檔案

精靈的錯誤處理

參考

自訂精靈

提供即時線上說明

其他資源

自訂精靈範例