共用方式為


如何:建立自訂選項頁面

.Visual Studio 增益集在 Visual Studio 2013 中已不適用。 您應該升級您的增益集至 VSPackage 擴充套件。 如需升級的詳細資訊,請參閱 常見問題集:將增益集轉換成 VSPackage 擴充功能

[選項] 對話方塊會顯示 Visual Studio 不同部分的各個選項頁。 您可以依照控制選項設定中所描述的方式控制現有的選項頁,也可以建立自訂的選項頁。 您可以使用自訂的選項頁,讓使用者變更增益集或其他程式的設定。

若要建立專屬自訂 [選項] 頁,您不必使用增益集,因為選項頁定義是儲存在 XML 檔中,而不是登錄機碼中。 因此,您可以建立 [選項] 頁,而且在 Visual Studio 整合式開發環境 (IDE) 和巨集 IDE 中都可以存取。

下列步驟示範如何建立要當做自訂 [選項] 頁的自訂使用者控制項,然後再修改 .addin 檔來參考該選項頁。

注意事項注意事項

根據您目前使用的設定或版本,您所看到的對話方塊與功能表指令可能會與 [說明] 中描述的不同。使用 [一般開發設定] 開發了這些程序。如果要變更設定,請按一下 [工具] 功能表上的 [匯入和匯出設定]。如需詳細資訊,請參閱Visual Studio 中的自訂開發設定

若要建立自訂選項頁

  1. 建立 Windows 控制項程式庫專案。 將其命名為 ToolsOptionsLibrary.dll。

  2. 加入所需的控制項和功能,

    這個使用者控制項即變成自訂的 [選項] 頁。 調整控制項的大小,使其填滿 [選項] 對話方塊的工作區。

  3. 建置專案。

    當 Visual Studio 啟動並載入現有的增益集時,會尋找所有共用的 .addin 檔。 名為 [增益集/巨集安全性] 的 [選項] 頁會為 .addin 檔的檔案路徑定義一組語彙基元。 其中包含下列語彙基元:

    • %ALLUSERSPROFILE%

    • %APPDATA%

    • %USERPROFILE%

    • %VSAPPDATA%

    • %VSCOMMONAPPDATA%

    當 Visual Studio 開始搜尋 .addin 檔案時,會使用下列路徑字串取代這些語彙基元:

    語彙基元

    路徑

    %ALLUSERSPROFILE%

    ..\Documents and Settings\All Users\Application Data\Microsoft\MSEnvShared\Addins\

    %APPDATA%

    ..\Documents and Settings\<username \Microsoft\MSEnvShared\Addins\

    %USERPROFILE%

    ..\Documents and Settings\<username\My Documents\Visual Studio 2010\Addins\

    %VSAPPDATA%

    ..\Documents and Settings\<username\Addins\

    %VSCOMMONAPPDATA%

    ..\Documents and Settings\All Users\Addins

    如需如何登錄增益集的詳細資訊,請參閱增益集安全性

  4. 在前面列出的其中一個目錄內建立 .addin 檔,以參考新的 [選項] 頁。

    您可以使用下列程式碼做為範本:

    <?xml version="1.0" encoding="UTF-16" standalone="no"?>
    <Extensibility xmlns="https://schemas.microsoft.com/AutomationExtensibility">
        <HostApplication>
            <Name>Microsoft Visual Studio Macros</Name>
            <Version>10.0</Version>
        </HostApplication>
        <HostApplication>
            <Name>Microsoft Visual Studio</Name>
            <Version>10.0</Version>
        </HostApplication>
        <ToolsOptionsPage>
            <Category Name="Environment">
                <SubCategory Name="My Tools Options Page">
                    <Assembly><dll location></Assembly>
                    <FullClassName>ToolsOptionsLibrary.UserControl1
                    </FullClassName>
                </SubCategory>
            </Category>
        </ToolsOptionsPage>
    </Extensibility>
    
  5. 在 <Assembly></Assembly> 標籤中,使用 ToolsOptionsLibrary.dll 的路徑取代 <dll location>。

  6. 變更 <ToolsOptionsPage><ToolsOptionsPage> 設定 (種類名稱、子分類名稱等) 以反映使用者控制項的自訂內容。

    例如,如果使用者控制項命名為 "NewPage" 而其專案為 "MyTOLib",則 FullClassName 標籤將會是 MyTOLib.NewPage。 Assembly 是選項 DLL 所在的位置。 Category Name 是您要在 [選項] 對話方塊中放置自訂選項頁的節點,例如 Environment、Debugging 或 Projects。

    如果您指定不存在的名稱,就會建立這個名稱的節點。 SubCategory 是顯示在節點底下的名稱。 請注意,最大的層級數是兩層。 您無法加入第三層的節點。

  7. 在前述增益集檔案資料夾中,將檔案另存成副檔名為 .addin 的文字檔。 預設的目錄是 ..\Documents and Settings\username\Application Data\Microsoft\MSEnvShared\Addins\

    當 Visual Studio 啟動時,會在這個目錄中尋找自訂的 [選項] 頁定義,然後載入找到的定義。 您可以在 [選項] 對話方塊中,使用 [Environment] 節點底下的 [增益集/巨集安全性] 頁來變更或加入增益集目錄。

  8. 啟動 Visual Studio,然後按一下 [工具] 功能表上的 [選項]。

    新的 [選項] 頁隨即出現。

請參閱

工作

如何:變更視窗特性

概念

控制選項設定

增益集登錄

Automation 物件模型圖表

其他資源

建立和控制環境視窗

Automation 與擴充性參考