提供可用的命令

發行項
03/24/2017

發行︰ 2016年7月

如需 Visual Studio 2017 的最新文件請參閱 Visual Studio 2017 文件。

多個 VSPackages 新增至 Visual Studio 時，可能會變得過擁擠使用者介面 (UI) 命令。您可以程式設計您的封裝，以協助降低這個問題，請如下︰

程式封裝以便載入只有當使用者需要它。
程式封裝，使其命令才會顯示在整合式的開發環境 (IDE) 的目前狀態的內容中可能會需要它們。

延遲載入

若要啟用的一般方式延遲載入是設計的 VSPackage，讓它的命令會顯示在 UI 中，但封裝本身不會載入直到使用者按一下其中一個命令。若要達成此目的，.vsct 檔案中，建立不具有任何命令旗標的命令。

下列範例會顯示來自.vsct 檔的功能表命令定義。這是 Visual Studio 封裝範本所產生的命令時功能表命令選取範本中的選項。

<Button guid="guidTopLevelMenuCmdSet" id="cmdidTestCommand" priority="0x0100" type="Button">  
  <Parent guid="guidTopLevelMenuCmdSet" id="MyMenuGroup" />  
  <Icon guid="guidImages" id="bmpPic1" />  
  <Strings>  
    <CommandName>cmdidTestCommand</CommandName>  
    <ButtonText>Test Command</ButtonText>  
  </Strings>  
</Button>

在範例中，如果父群組， MyMenuGroup，是最上層功能表的子系，例如工具] 功能表，此命令會顯示在該功能表上，但直到使用者按一下此命令時，將不會載入之封裝的執行命令。但是，透過程式設計來實作命令IOleCommandTarget介面，您可以啟用封裝以載入第一次展開的功能表命令時。

請注意延遲的載入也可改善啟動效能。

目前的內容和命令的可見性

您可以程式設計 VSPackage 命令要顯示或隱藏，根據 VSPackage 資料或目前相關的動作的目前狀態。您可以啟用狀態進行設定其命令，通常使用的實作 VSPackage QueryStatus方法從IOleCommandTarget介面，但這需要才能夠執行程式碼要載入 VSPackage。相反地，我們建議您啟用 IDE 管理命令的可見性，而不載入封裝。若要這樣做，.vsct 檔案中，關聯一個或多個特殊的 UI 內容中的命令。這些 UI 內容由稱為 GUID 識別命令內容 GUID。

Visual Studio監視所產生的使用者動作，例如載入專案，或編輯要建置變更。發生變更時，會自動修改 IDE 的外觀。下表顯示 IDE 的四個主要內容變更，Visual Studio監視。

內容的型別	說明
使用中的專案類型	對於大部分的專案類型，這`GUID`值是可實作專案 VSPackage 的 GUID 相同。不過，Visual C++專案使用 [專案類型`GUID`做為值。
使用中視窗	一般而言，這是最近一次的主動式文件視窗，以建立索引鍵繫結的目前 UI 內容。不過，它也可能是類似於內部的 Web 瀏覽器的索引鍵繫結資料表的工具視窗。 HTML 編輯器之類的多個索引標籤的文件視窗，如每個索引標籤會有不同的命令內容`GUID`。
作用中的語言服務	目前顯示在文字編輯器中的檔案與相關聯之語言服務。
使用中工具視窗	已開啟，而且具有焦點的視窗。

第五個主要內容區域是 IDE 的 UI 狀態。作用中的命令內容來識別 UI 內容GUIDs，如下所示︰

這些 Guid 會標示為作用中或非作用中，根據 IDE 的目前狀態。在相同的時間可以使用多個 UI 的內容。

隱藏和顯示內容為基礎的命令

您可以顯示或隱藏在 IDE 中的封裝] 命令，而不載入封裝本身。若要這樣做，請定義命令.vsct 檔的封裝中使用DefaultDisabled， DefaultInvisible，和DynamicVisibility命令旗標並新增一或多個VisibilityItem項目VisibilityConstraints一節。當指定的命令內容GUID會變成作用中，此命令會顯示不含載入封裝。

自訂內容的 Guid

如果未定義的 GUID 不適當的命令內容中，您可以定義在 VSPackage 中，然後進行程式設計，讓它成為作用中或非作用中，視需要控制命令的可見性。使用SVsShellMonitorSelection服務︰

註冊內容 Guid (藉由呼叫GetCmdUIContextCookie方法)。
取得內容的狀態GUID(藉由呼叫IsCmdUIContextActive方法)。
開啟內容GUIDs 開啟和關閉 (藉由呼叫SetCmdUIContext方法)。

注意

請確定，VSPackage 不會影響任何現有內容 GUID 的狀態因為其他 VSPackages 可能需要使用它們。

範例

VSPackage 命令的下列範例會示範動態的可見性，其中一個命令，而不載入 VSPackage 由命令的內容。

命令是設定為啟用，而且方案存在，只要顯示亦即，每當下列的命令內容 Guid 的其中一個是使用中︰

在範例中，請注意，每個命令旗標是個別命令旗標項目。

<Button guid="guidDynamicVisibilityCmdSet" id="cmdidMyCommand"   
        priority="0x0100" type="Button">  
  <Parent guid="guidDynamicVisibilityCmdSet" id="MyMenuGroup" />  
  <Icon guid="guidImages" id="bmpPic1" />  
  <CommandFlag>DefaultDisabled</CommandFlag>  
  <CommandFlag>DefaultInvisible</CommandFlag>  
  <CommandFlag>DynamicVisibility</CommandFlag>  
  <Strings>  
    <CommandName>cmdidMyCommand</CommandName>  
    <ButtonText>My Command name</ButtonText>  
  </Strings>  
</Button>

也請注意，必須在個別指定每個 UI 內容VisibilityItem項目，如下所示。

<VisibilityConstraints>  
  <VisibilityItem guid="guidDynamicVisibilityCmdSet"  
                  id="cmdidMyCommand" context="UICONTEXT_EmptySolution" />  
  <VisibilityItem guid="guidDynamicVisibilityCmdSet"  
                      id="cmdidMyCommand" context="UICONTEXT_SolutionHasSingleProject" />  
  <VisibilityItem guid="guidDynamicVisibilityCmdSet"  
                  id="cmdidMyCommand" context="UICONTEXT_SolutionHasMultipleProjects" />  
</VisibilityConstraints>

另請參閱

MenuCommands Vs。OleMenuCommands
VSPackages 如何新增使用者介面項目
 Vspackage 中的命令路由
 以動態方式加入功能表項目

共用方式為