GalleryButton 要素 (グループ)

  • [アーティクル]

最終更新日: 2015年3月9日

適用対象: SharePoint Foundation 2010

この記事の内容
属性
子要素
親要素
出現回数

ギャラリー ボタンを定義します。

<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

オプション。コントロールで使用される代替のテキスト。

Command

オプション。コントロールがクリックされたときに実行するコマンドの名前。コントロールが CommandUIDefinition 要素内にある場合、コントロールの Command 属性の値は、対応する CommandUIHandler 要素の Command 属性の値と同じである必要があります。

CommandPreview

オプション。選択をプレビューするために実行するコマンドの名前。

CommandRevert

オプション。選択をプレビューする前に存在した状態に戻るために実行するコマンドの名前。

CommandType

オプション。コマンドの種類を指定する列挙値。

  • General。特定の種類のコマンドではありません。

  • 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

オプション。ツールヒントで使用する 32 x 32 ピクセルの画像を含むファイルのサーバー相対 URL ("/_layouts/1033/images/formatmap32x32.png" など)。

ToolTipImage32by32Class

オプション。ツールヒントの画像に適用される CSS セレクターの名前。

ToolTipImage32by32Left

オプション。画像の左端のオフセットを表す負の整数。ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。ToolTipImage32by32Left 属性の値は、ページが作成されるときに CSS left 属性を設定するために使用します。

ToolTipImage32by32Top

オプション。画像の上端のオフセットを表す負の整数。ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。ToolTipImage32by32Top 属性の値は、ページが作成されるときに CSS top 属性を設定するために使用します。

ToolTipTitle

オプション。ツールヒントのタイトルとして表示するテキスト。

ToolTipDescription

オプション。ツールヒントの本文に表示するテキスト。

ToolTipHelpKeyWord

オプション。コンテキスト ヘルプで使用するキーワード。

ToolTipShortcutKey

オプション。ツールヒントに表示するショートカット キーのテキスト。たとえば、コントロールのショートカット キーが ALT + J の場合、この属性の値は "ALT + J" になります。ツールヒントでは、このショートカット キーのテキストがツールヒント タイトルの後にかっこに囲まれて表示されます。例: "(ALT + J)"。

子要素

なし

親要素

CommandUIDefinition

Controls (Group)

出現回数

最小: 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>