GalleryButton 要素 (グループ) (サーバー リボン)
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
ギャラリー ボタンを定義します。
<GalleryButton
Alt="Text"
Command="Text"
CommandPreview="Text"
CommandRevert="Text"
CommandType="General | OptionSelect | IgnoredByMenu"
CommandValueId="Text"
ElementDimensions="Size16by16 | Size32by32 | Size48by48 | Size72by96 | Size96by72 | Size96by96 | Size128by128 | Size190by30 | Size190by40 | Size190by50 | Size190by60"
Id="Text"
Image="Url"
ImageClass="CSS Selector"
ImageLeft="Negative Integer"
ImageTop="Negative Integer"
InnerHTML="HTML"
MenuItemId="Text"
QueryCommand="Text"
Sequence="Integer"
TemplateAlias="Text"
ToolTipImage32by32="Url"
ToolTipImage32by32Class="CSS Selector"
ToolTipImage32by32Left="Negative Integer"
ToolTipImage32by32Top="Negative Integer"
ToolTipTitle="Text"
ToolTipDescription="Text"
ToolTipHelpKeyWord="Text"
ToolTipShortcutKey="Text"
/>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
| Alt |
オプション。 コントロールで使用される代替のテキスト。 |
| コマンド |
オプション。 コントロールが選択されたときに実行するコマンドの名前。 コントロールが CommandUIDefinition 要素内にある場合、コントロールの Command 属性の値は、対応する CommandUIHandler 要素の Command 属性の値と同じである必要があります。 |
| CommandPreview |
オプション。 選択をプレビューするために実行するコマンドの名前。 |
| CommandRevert |
オプション。 選択をプレビューする前に存在した状態に戻るために実行するコマンドの名前。 |
| CommandType |
オプション。 コマンドの種類を指定する列挙値。 全般。 特定の種類のコマンドではありません。 OptionSelection。 ユーザーがオプション グループ内の 1 つのオプションを選択するときに生成されるコマンド。 IgnoredByMenu。 メニューを選択したときに閉じてはいけないコントロールに使用されるコマンド。 |
| CommandValueId |
オプション。 ボタンが選択されたときにコマンド イベントと共に送信される文字列。 |
| ElementDimensions |
必須です。 ボタンがレンダリングされる四角形の領域のサイズを指定する列挙値。 このサイズはピクセル単位で表され、形式は "幅 x 高さ" です。 Size16by16 Size32by32 Size48by48 Size72by96 Size96by72 Size96by96 Size128by128 Size190by30 Size190by40 Size190by50 Size190by60 |
| Id |
必須です。 "buttonStaticStyle1" などの要素を識別する文字列。 |
| Image |
オプション。 アイコンとして使用する画像を含むファイルへのサーバー相対 URL。 Image 属性を定義しない場合、InnerHTML 属性を定義する必要があります。 |
| Imageclass |
オプション。 画像に適用される CSS クラス セレクターの名前。 |
| ImageLeft |
オプション。 画像の左端のオフセットを表す負の整数。 この属性は、Image 属性が、複数のアイコンの画像を含む画像ファイルを指している場合に使用します。 |
| ImageTop |
オプション。 画像の上端のオフセットを表す負の整数。 この属性は、Image 属性が、複数のアイコンの画像を含む画像ファイルを指している場合に使用します。 |
| Innerhtml |
オプション。 ボタンが表す選択肢を示す HTML マークアップ。 InnerHTML 属性を定義しない場合、Image 属性を定義する必要があります。 |
| MenuItemId |
オプション。 ボタンが配置されている場所のメニュー項目を識別する文字列。 |
| QueryCommand |
オプション。 状態情報をポーリングするときに実行するコマンドの名前。 |
| Sequence |
オプション。 兄弟 XML ノード間の配置順序を指定する整数。 |
| TemplateAlias |
オプション。 GroupTemplate 要素内の ControlRef 要素、OverflowArea 要素、または OverflowSection 要素の TemplateAlias 属性の値に一致する文字列。 TemplateAlias 属性は、テンプレートをグループに適用するときにグループ内でコントロールのサイズと位置を調整するために使用されます。 |
| ToolTipImage32by32 |
オプション。 "/_layouts/1033/images/formatmap32x32.png" など、ツールヒントで使用される 32 x 32 ピクセルのイメージを含むファイルへのサーバー相対 URL。 |
| ToolTipImage32by32Class |
オプション。 ツールヒントの画像に適用される CSS セレクターの名前。 |
| ToolTipImage32by32Left |
オプション。 画像の左端のオフセットを表す負の整数。 ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 ToolTipImage32by32Left 属性の値は、ページが作成されるときに CSS left 属性を設定するために使用します。 |
| ToolTipImage32by32Top |
オプション。 画像の上端のオフセットを表す負の整数。 ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 ToolTipImage32by32Top 属性の値は、ページが作成されるときに CSS top 属性を設定するために使用します。 |
| ToolTipTitle |
オプション。 ツールヒントのタイトルとして表示するテキスト。 |
| ToolTipDescription |
オプション。 ツールヒントの本文に表示するテキスト。 |
| ToolTipHelpKeyWord |
オプション。 コンテキスト ヘルプで使用するキーワード。 |
| ToolTipShortcutKey |
オプション。 ヒントのショートカット キーに表示するテキスト。 たとえば、コントロールのショートカット キーが Alt + J の場合、この属性の値は "Alt + J" になります。 ヒントのタイトル "(Alt + J)" の後に、ショートカット キーのテキストがかっこ内に表示されます。 |
子要素
None
親要素
- CommandUIDefinition
- Controls (Group)
Occurrences
- 最小: 0
- 最大: 制約なし
例
以下の XML フラグメントは、書式設定スタイルを適用するときに使用されるギャラリー ボタン コントロールのグループを定義しています。
<Group
Id="grpStyles"
Description=""
Title="Group Styles"
Template="tmpStyles">
<Controls>
<GalleryButton
Id="buttonStaticStyle1"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle1&quot; id=&quot;labelPreviewContent0&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle0&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading1"
Alt="Heading1"
TemplateAlias="preview1"/>
<GalleryButton
Id="buttonStaticStyle2"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle2&quot; id=&quot;labelPreviewContent1&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle1&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading2"
Alt="Heading2"
TemplateAlias="preview2"/>
<GalleryButton
Id="buttonStaticStyle3"
QueryCommand="QueryStyle"
Command="ApplyStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle3&quot; id=&quot;labelPreviewContent2&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle2&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Heading3"
Alt="Heading3"
TemplateAlias="preview3"/>
<GalleryButton
Id="buttonStaticStyle4"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle4&quot; id=&quot;labelPreviewContent3&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle3&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Quote"
Alt="Quote"
TemplateAlias="preview4"/>
<GalleryButton
Id="buttonStaticStyle5"
Command="ApplyStyle"
QueryCommand="QueryStyle"
InnerHTML="&lt;DIV class=&quot;PreviewStyleContainer&quot;&gt;&lt;P class=&quot;PreviewStaticStyle5&quot; id=&quot;labelPreviewContent4&quot;&gt;&lt;/P&gt;&lt;P class=&quot;PreviewStyleLabel&quot; id=&quot;labelPreviewStyle4&quot;&gt;&lt;/P&gt;&lt;/DIV&gt;"
ElementDimensions="Size64by48"
LabelText="Citation"
Alt="Citation"
TemplateAlias="preview5"/>
<FlyoutAnchor
Alt="STR@L_MenuMoreStyles"
Id="fsfaMoreStyles"
Command="MenuOpenEditOnly"
MenuAlt="STR@L_MenuMoreStyles"
LabelText="STR@L_MenuMoreStyles"
Image32by32="IMGMAP@one@UxGalWordQuickFormatsHH"
TemplateAlias="morestyles"
PopulateDynamically="true"
PopulateOnlyOnce="false"
PopulateQueryCommand="PopulateMenuMoreStyles"
CommandMenuClose="MenuClose"
CacheMenuVersions="false">
</FlyoutAnchor>
</Controls>
</Group>