ボタン要素
ユーザーが操作できる要素を定義します。 ボタンは、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 コマンド識別子の ID。 |
priority | 省略可能。 優先順位を指定する数値。 |
type | 省略可能。 ボタンの種類を指定する列挙値。 指定されていない場合は、Button を使用します。 Button ツール バー (通常はアイコン化されたボタンとして)、メニュー、コンテキスト メニューに表示される標準コマンド。 MenuButton コマンドは実行しないが、別のメニューを生成するメニュー項目。 SplitDropDown Microsoft Word の標準ツール バーにある [元に戻す] ボタンや [やり直し] ボタンなどのコントロール。 |
条件 | 省略可能。 条件付き属性に関するページを参照してください。 |
子要素
要素 | 説明 |
---|---|
親要素 | 省略可能。 ボタンの親要素。 |
Icon 要素 | 省略可能。 ボタンに関連付けられているアイコン。 |
コマンド フラグ要素 | 必須。 Button の有効な CommandFlag 値は次のとおりです。 - AllowParams - CommandWellOnly - DefaultDisabled - DefaultInvisible - DontCache - DynamicItemStart - DynamicVisibility - FixMenuController - IconAndText - NoButtonCustomize - NoCustomize - NoKeyCustomize - NoShowOnMenuController - Pict - PostExec - ProfferedCmd - RouteToDocs - TextCascadeUseBtn - TextMenuUseButton - TextChanges - TextChangesButton - TextContextUseButton - TextMenuCtrlUseMenu - TextMenuUseButton - TextOnly |
Strings 要素 | 必須。 子の ButtonText 要素を定義する必要があります。 |
注釈 | 省略可能なコメント。 |
親要素
要素 | 説明 |
---|---|
Buttons 要素 | Button 要素をグループ化します。 |
例
次の例では、.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>