Button 項目

定義使用者可以與之互動的項目。 有四種按鈕的如下所示： 按鈕、 MenuButton、 SplitDropDown 和樣本。

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
  <Parent>... </Parent>
  <Icon>... </Icon>
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</Button>

屬性和項目

下列章節會說明屬性、子項目和父項目。

屬性

屬性	描述
guid	必要項。 GUID /ID 命令識別項的 GUID。
id	必要項。 GUID /ID 命令識別項的識別碼。
priority	選擇項。 數字的值，指定的優先權。
type	選擇項。 列舉的值，指定的按鈕類型。 如果未指定，會使用] 按鈕。 Button 標準的命令，就會出現在工具列上 (通常是一個圖示的按鈕)，功能表和快顯功能表。 MenuButton 功能表項目將不會執行一個指令，但會產生另一個功能表。 SplitDropDown 控制項，例如 Microsoft Word 中的 [一般] 工具列上的 [復原和取消復原] 按鈕。
條件	選擇項。 請參閱 VSCT XML 結構描述條件式屬性。

子項目

項目	描述
Parent 項目	選擇項。 按鈕的父項目。
Icon 項目	選擇項。 與按鈕關聯的圖示。
CommandFlag 項目	必要項。 按鈕有效的 CommandFlag 值如下所示。 AllowParams CommandWellOnly DefaultDisabled DefaultInvisible DontCache DynamicItemStart DynamicVisibility FixMenuController IconAndText NoButtonCustomize NoCustomize NoKeyCustomize NoShowOnMenuController Pict PostExec ProfferedCmd RouteToDocs TextCascadeUseBtn TextMenuUseButton 文字變更 TextChangesButton TextContextUseButton TextMenuCtrlUseMenu TextMenuUseButton TextOnly
Strings 項目	必要項。 子系ButtonText 項目必須定義。
註釋	選擇性的註解。

父項目

項目	描述
Buttons 項目	按鈕項目分組。

範例

下列範例會定義在.vsct 檔案中的按鈕。

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

請參閱

其他資源

Visual Studio 命令表裡 (。Vsct) 檔案