適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
コントロールのグループを定義します。
<Group
Command="Text"
Description="Text"
Id="Text"
Image32by32Popup="Url"
Image32by32PopupClass="CSS Class Selector"
Image32by32PopupLeft="Negative Integer"
Image32by32PopupTop="Negative Integer"
Sequence="Integer"
Template="Text"
Title="Text"
/>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
属性 | 説明 |
---|---|
コマンド |
オプション。 値は、グループ内のコントロールを有効または無効にするために使用されます。 Command 属性が存在し、値がある場合は、リボンによってポーリングされ、コマンドが無効になっているかどうかを確認します。 無効にした場合、リボンはグループ内のコントロールに関連付けられているコマンドをポーリングしません。コントロールも効果的に無効になります。 |
説明 |
オプション。 グループの説明。 |
Id |
必須です。 グループを識別する文字列 ("Ribbon.DocLibListForm.Edit.Clipboard" など)。 |
Image32by32Popup |
オプション。 "/_layouts/1033/images/formatmap32x32.png" など、グループを表すために使用される 32 x 32 ピクセルのイメージを含むファイルへのサーバー相対 URL。 |
Image32by32PopupClass |
オプション。 画像に適用される CSS クラス セレクターの名前。 |
Image32by32PopupLeft |
オプション。 画像の左端のオフセットを表す負の整数。 Image32by32Popup 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 Image32by32PopupLeft 属性の値は、HTML img タグのインライン スタイルの CSS left 属性を設定するために使用します。 |
Image32by32PopupTop |
オプション。 画像の上端のオフセットを表す負の整数。 Image32by32Popup 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。 Image32by32PopupTop 属性の値は、HTML img タグのインライン スタイルの CSS top 属性を設定するために使用します。 |
Sequence |
オプション。 兄弟 XML ノード間の配置順序を指定する整数。 |
Template |
オプション。 GroupTemplate 要素の Id 属性に対応する文字列。 |
Title |
オプション。 リボンとヒントにグループのタイトルとして表示されるテキスト。 |
子要素
親要素
Occurrences
- 最小: 0
- 最大: 制約なし
例
次の XML フラグメントは、2 つのボタンを含んでいるグループを定義しています。
<Group
Id="Ribbon.WikiPageTab.CustomGroup"
Sequence="55"
Description="Custom Group"
Title="Custom"
Command="EnableCustomGroup"
Template="Ribbon.Templates.Flexible2">
<Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
<Button
Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello"
Command="CustomGroupHelloWorld"
Image16by16="/_layouts/images/FILMSTRP.GIF"
Image32by32="/_layouts/images/PPEOPLE.GIF"
LabelText="Hello, World"
TemplateAlias="o2"
Sequence="15" />
<Button
Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye"
Command="CustomGroupGoodbyeWorld"
Image16by16="/_layouts/images/FILMSTRP.GIF"
Image32by32="/_layouts/images/PPEOPLE.GIF"
LabelText="Good-bye, World"
TemplateAlias="o2"
Sequence="18" />
</Controls>
</Group>