GalleryButton 要素 (ギャラリー) (サーバー リボン)GalleryButton element (Gallery) (Server Ribbon)

に適用されます: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint オンライン |SharePoint Server 2013Applies to: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

ギャラリー ボタンを定義します。Defines a gallery button.

<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="Text"
  TemplateAlias="Text"
  ToolTipImage32by32="Url"
  ToolTipImage32by32Class="CSS Class Selector"
  ToolTipImage32by32Left="Negative Integer"
  ToolTipImage32by32Top="Negative Integer"
  ToolTipTitle="Text"
  ToolTipDescription="Text"
  ToolTipHelpKeyWord="Text"
  ToolTipShortcutKey="Text"
/>

要素と属性Elements and attributes

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
Alt キーを押しAlt
オプション。コントロールで使用される代替のテキスト。Optional. Alternative text that is used for the control.
CommandCommand
省略可能。Optional. コントロールが選択されたときに実行するコマンドの名前。The name of the command to execute when the control is selected. CommandUIDefinition要素内のコントロールの場合は、コントロールの [コマンド] 属性の値は対応するCommandUIHandler要素の [コマンド] 属性の値と同じにします。If the control is in a CommandUIDefinition element, the value of the Command attribute of the control should be the same as the value of the Command attribute of a corresponding CommandUIHandler element.
CommandPreviewCommandPreview
オプション。選択をプレビューするために実行するコマンドの名前。Optional. The name of the command to execute for previewing a selection.
CommandRevertCommandRevert
オプション。選択をプレビューする前に存在した状態に戻るために実行するコマンドの名前。Optional. The name of the command to execute to return to the state that existed before previewing a selection.
コマンド タイプ。CommandType
オプション。コマンドの種類を指定する列挙値。Optional. An enumeration value that specifies the type of command.
全般General. ない特定の種類のコマンドです。Not a specific type of command.
OptionSelectionOptionSelection. ユーザーがオプション グループのオプションの 1 つを選択したときに生成されるコマンドです。A command that is generated when a user selects one option in an option group.
IgnoredByMenuIgnoredByMenu. コントロールを閉じない、メニュー選択時に使用するコマンドです。A command that is used for controls that should not close the menu when they are selected.
CommandValueIdCommandValueId
省略可能。Optional. ボタンが選択されているときにコマンド イベントと共に送信される文字列です。A string that is sent with the command event when the button is selected.
ElementDimensionsElementDimensions
必須。ボタンがレンダリングされる四角形の領域のサイズを指定する列挙値。このサイズはピクセル単位で表され、形式は "幅 x 高さ" です。Required. An enumeration value that specifies the dimensions of the rectangle in which the button is rendered. Dimensions are in pixels and are in the format "width by height".
Size16by16Size16by16
Size32by32Size32by32
Size48by48Size48by48
Size72by96Size72by96
Size96by72Size96by72
Size96by96Size96by96
Size128by128Size128by128
Size190by30Size190by30
Size190by40Size190by40
Size190by50Size190by50
Size190by60Size190by60
IdId
必須。Required. "ButtonStaticStyle1"など、要素を識別する文字列です。A string that identifies the element, such as "buttonStaticStyle1".
ImageImage
オプション。アイコンとして使用する画像を含むファイルへのサーバー相対 URL。Optional. A server-relative URL to a file that contains an image to be used as an icon.
イメージ属性が定義されていない場合、 InnerHTML属性を定義する必要があります。If an Image attribute is not defined, an InnerHTML attribute must be defined.
ImageClassImageClass
オプション。画像に適用される CSS クラス セレクターの名前。Optional. The name of a CSS class selector to be applied to the image.
ImageLeftImageLeft
省略可能。Optional. イメージの左端までのオフセットを表す負の整数です。A negative integer that represents an offset for the left edge of the image. イメージの属性がいくつかのアイコンのイメージを含むイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the Image attribute points to an image file that contains images for several icons.
ImageTopImageTop
省略可能。Optional. イメージの上端の座標のオフセットを表す負の整数です。A negative integer that represents an offset for the top edge of the image. イメージの属性がいくつかのアイコンのイメージを含むイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the Image attribute points to an image file that contains images for several icons.
InnerHTMLInnerHTML
オプション。ボタンが表す選択肢を示す HTML マークアップ。Optional. HTML markup that illustrates the choice that the button represents.
InnerHTML属性が定義されていない場合に、イメージの属性を定義する必要があります。If the InnerHTML attribute is not defined, the Image attribute must be defined.
MenuItemIdMenuItemId
オプション。ボタンが配置されている場所のメニュー項目を識別する文字列。Optional. A string that identifies the menu item where the button is located.
QueryCommandQueryCommand
オプション。状態情報をポーリングするときに実行するコマンドの名前。Optional. The name of the command to execute when polling for state information.
SequenceSequence
オプション。兄弟 XML ノード間の配置順序を指定する整数。Optional. An integer that specifies the order of placement among sibling XML nodes.
TemplateAliasTemplateAlias
省略可能。Optional. ControlRef要素、 OverflowAreaの要素、またはため要素内のOverflowSection要素のTemplateAlias属性の値に一致する文字列です。A string that matches the value of the TemplateAlias attribute for a ControlRef element, an OverflowArea element, or an OverflowSection element in a GroupTemplate element. TemplateAlias属性は、サイズを使用し、テンプレートと、グループ内での位置のコントロールがグループに適用します。The TemplateAlias attribute is used to size and position controls within a group when a template is applied to the group.
ToolTipImage32by32ToolTipImage32by32
省略可能。Optional. 次のように、ツール ヒントに使用する 32 × 32 ピクセルのイメージを含むファイルへの相対 URL"/_layouts/1033/images/formatmap32x32.png"です。A server-relative URL to a file that contains a 32-by-32-pixel image to be used in the tooltip, such as "/_layouts/1033/images/formatmap32x32.png".
ToolTipImage32by32ClassToolTipImage32by32Class
オプション。ツールヒントの画像に適用される CSS クラス セレクターの名前。Optional. The name of a CSS class selector to be applied to the tooltip image.
ToolTipImage32by32LeftToolTipImage32by32Left
省略可能。Optional. イメージの左端までのオフセットを表す負の整数です。A negative integer that represents an offset for the left edge of the image. ToolTipImage32by32属性は、多くのアイコンの画像が含まれるイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. ToolTipImage32by32Left属性の値を使用して、ページの作成時に HTML のimgタグのインライン スタイルの CSS のleft属性を設定します。The value of the ToolTipImage32by32Left attribute is used to set the CSS left attribute for the inline style of an HTML img tag when the page is created.
ToolTipImage32by32TopToolTipImage32by32Top
省略可能。Optional. イメージの上端の座標のオフセットを表す負の整数です。A negative integer that represents an offset for the top edge of the image. ToolTipImage32by32属性は、多くのアイコンの画像が含まれるイメージ ファイルをポイントしたときは、この属性を使用します。Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. ToolTipImage32by32Top属性の値を使用して、ページの作成時に HTML のimgタグのインライン スタイルの CSSの属性を設定します。The value of the ToolTipImage32by32Top attribute is used to set the CSS top attribute for the inline style of an HTML img tag when the page is created.
ToolTipTitleToolTipTitle
オプション。ツールヒントのタイトルとして表示するテキスト。Optional. The text that appears as the title of the tooltip.
ToolTipDescriptionToolTipDescription
オプション。ツールヒントの本文に表示するテキスト。Optional. The text that appears in the body of the tooltip.
ToolTipHelpKeyWordToolTipHelpKeyWord
オプション。コンテキスト ヘルプで使用するキーワード。Optional. The keyword that is used by context-sensitive Help.
ToolTipShortcutKeyToolTipShortcutKey
省略可能。Optional. ツール ヒントにショートカット キーを表示するテキストです。The text to display for the shortcut key in the tooltip. コントロールのショートカット キーが alt キーを押しながら J の場合は、この属性の値は「Alt + J」です。For example, if the shortcut key for the control is Alt+J, the value for this attribute is "Alt+J". ツールチップが表示のテキストのショートカット キーをかっこで囲まれた、ツールヒントのタイトル後:"(Alt+J)"です。The tooltip will display the text for the shortcut key in parentheses after the tooltip title: "(Alt+J)".

子要素Child elements

なしNone

親要素Parent elements

出現回数Occurrences

  • 最小: 1Minimum: 1
  • 最大: 制約なしMaximum: unbounded