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.
CommandTypeCommandType
オプション。コマンドの種類を指定する列挙値。Optional. An enumeration value that specifies the type of command.
General。特定の種類のコマンドではありません。General. Not a specific type of command.
OptionSelection。ユーザーがオプション グループ内の 1 つのオプションを選択するときに生成されるコマンド。OptionSelection. 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.
Image 属性を定義しない場合、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
オプション。画像の左端のオフセットを表す負の整数。この属性は、Image 属性が、複数のアイコンの画像を含む画像ファイルを指している場合に使用します。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
オプション。画像の上端のオフセットを表す負の整数。この属性は、Image 属性が、複数のアイコンの画像を含む画像ファイルを指している場合に使用します。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 属性を定義しない場合、Image 属性を定義する必要があります。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
オプション。GroupTemplate 要素内の ControlRef 要素、OverflowArea 要素、または OverflowSection 要素の TemplateAlias 属性の値に一致する文字列。TemplateAlias 属性は、テンプレートをグループに適用するときにグループ内でコントロールのサイズと位置を調整するために使用されます。Optional. 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. 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
オプション。画像の左端のオフセットを表す負の整数。ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。ToolTipImage32by32Left 属性の値は、ページが作成されたとき、HTML img タグのインライン スタイルの CSS left 属性を設定するために使用します。Optional. A negative integer that represents an offset for the left edge of the image. Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. 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
オプション。画像の上端のオフセットを表す負の整数。ToolTipImage32by32 属性が、多くのアイコンの画像を含む画像ファイルを指定している場合に、この属性を使用します。ToolTipImage32by32Top 属性の値は、ページが作成されたとき、HTML img タグのインライン スタイルのための CSS top 属性を設定するために使用します。Optional. A negative integer that represents an offset for the top edge of the image. Use this attribute when the ToolTipImage32by32 attribute points to an image file that contains the images for many icons. 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