<GalleryButton> (RibbonDiffXml)

  • [アーティクル]

適用対象: CRM 2016 on-prem, CRM Online

削除: ギャラリー要素内のボタン コントロールを指定しました。

重要

This control was deprecated in Microsoft Dynamics CRM 2011. This control will not render with Microsoft Dynamics CRM Online 2016 更新プログラムおよび Microsoft Dynamics CRM 2016 (設置型).

構文

<GalleryButton 
 Alt="String"
 Command="String"
 CommandPreview="String"
 CommandRevert="String"
 CommandType=["General" | "OptionSelection" | "IgnoredByMenu"]
 CommandValueId="String"
 ElementDimensions=
  ["Size16by16" |
  "Size32by32" |
  "Size48by48" |
  "Size64by48" |
  "Size72by96" |
  "Size96by72" |
  "Size96by96" |
  "Size128by128" |
  "Size190by30" |
  "Size190by40" |
  "Size190by50" |
  "Size190by60"]
 Id="String"
 Image="String"
 ImageClass="String"
 ImageLeft="Non Positive Integer"
 ImageTop="Non Positive Integer"
 InnerHTML="String"
 MenuItemId="String"
 QueryCommand="String"
 Sequence="Integer"
 TemplateAlias="String"
 ToolTipDescription="String"
 ToolTipHelpKeyWord="String"
 ToolTipImage32by32="String"
 ToolTipImage32by32Class="String"
 ToolTipImage32by32Left="Non Positive Integer"
 ToolTipImage32by32Top="Non Positive Integer"
 ToolTipShortcutKey="String"
 ToolTipTitle="String"
/>

属性と要素

The following table lists the attributes, child elements, and parent elements.

属性

Attribute Description Type Usage

Alt

代替テキストとして表示する文字列またはローカライズされたラベルへの参照。

String

Optional

Command

このコントロールのリボン コマンドの ID を指定します。

String

Optional

CommandPreview

コントロールを選択する前にそのコントロールにカーソルを置くときに実行するリボン コマンドの ID を指定します。

String

Optional

CommandRevert

ユーザーが undo を選択するときに実行するリボン コマンドの ID を指定します。

String

Optional

CommandType

別の種類のコマンドの指定を許可します。

Valid values:

 

Value Description

General

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

OptionSelection

ユーザーがオプション グループの 1 つのオプションを選択したときに生成されるコマンド。

IgnoredByMenu

クリックしたときにメニューを閉じないコントロールに使用するコマンド。

Enumeration

Optional

CommandValueId

ボタンがクリックされたときにコマンド イベントと共に送信される文字列。

String

Optional

ElementDimensions

Gallery または GalleryButton 要素のサイズを制御します。

Valid values:

  • Size16by16

  • Size32by32

  • Size48by48

  • Size64by48

  • Size72by96

  • Size96by72

  • Size96by96

  • Size128by128

  • Size190by30

  • Size190by40

  • Size190by50

  • Size190by60

Enumeration

Optional

Id

リボン要素の定義の一意の識別子を指定します。[solution identifier].[entity].[ribbon].[function].[element name] のように、命名規則として、名前の各部をピリオドを使用して分割することを強くお勧めします。たとえば、MyISV.account.form.SendToOtherSystem.Button のように指定します。

Use the {!EntityLogicalName} token in the Id attribute when you define a ribbon element that will be used for multiple entities. This inserts the entity logical name into the Id value to make sure that the Id value is globally unique.

For example, if you use MyISV.{!EntityLogicalName}.form.SendToOtherSystem.Button with the account entity, the Id will be MyISV.account.form.SendToOtherSystem.Button. For the contact entity, the Id will be MyISV.contact.form.SendToOtherSystem.Button.

重要

If you don’t set a globally unique Id value, the ribbon might not display.

String

Required

Image

A server-relative URL to a file that contains an image to be used as an icon.If an Image attribute is not defined, an InnerHTML attribute must be defined.

String

Optional

ImageClass

The name of a CSS class selector to be applied to the image.

String

Optional

ImageLeft

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.

Non positive Integer

Optional

ImageTop

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.

Non positive Integer

Optional

InnerHTML

HTML markup that illustrates the choice that the button represents.If the InnerHTML attribute is not defined, the Image attribute must be defined.

String

Optional

MenuItemId

コントロールからメニュー項目の ID への参照を指定します。

String

Optional

QueryCommand

状態情報をポーリングするときに実行するコマンドの名前を指定します。

String

Optional

Sequence

Sequence の値を既存のリボン要素よりも大きく、または小さく設定することによってリボンの変更の場所を指定します。

Integer

Optional

TemplateAlias

Layout 要素の子の中の場所のプレースホルダーに CommandUIDefinition のリボン要素の子を関連付けます。この値は、レイアウトが変更されたときにコントロールのグループ内でコントロールが表示される場所を定義します。

String

Optional

ToolTipDescription

コントロールのツールヒントに表示する文字列を指定します。$LocLabels: ディレクティブを使用すると、LocLabel 要素を参照できます。たとえば、"$LocLabels:MyISV.account.Save.Button.Tooltip" のように指定します。

String

Optional

ToolTipHelpKeyWord

この要素は Microsoft Dynamics CRM では使用されません。

String

Optional

ToolTipImage32by32

ツールヒントに表示する 32 x 32 ピクセルのイメージを指定します。

String

Optional

ToolTipImage32by32Class

ツールヒントに表示する 32 x 32 ピクセルのイメージに適用する CSS クラスを指定します。

String

Optional

ToolTipImage32by32Left

ツールヒントの 32 x 32 ピクセルのイメージを左に移動するためのピクセル数を指定します。これは負の数で表されます。

Non positive Integer

Optional

ToolTipImage32by32Top

ツールヒントの 32 x 32 ピクセルのイメージを先頭に移動するためのピクセル数を指定します。これは負の数で表されます。

Non positive Integer

Optional

ToolTipShortcutKey

この要素は Microsoft Dynamics CRM では使用されません。

String

Optional

ToolTipTitle

コントロールのツールヒントのタイトルに表示する文字列を指定します。通常、これは LabelText コントロールと同じ値です。$LocLabels: ディレクティブを使用すると、LocLabel 要素を参照できます。たとえば、"$LocLabels:MyISV.account.Save.Button.Label" のように指定します。

String

Optional

下位要素

この要素には子要素はありません。

親要素

Element Description

<Gallery> (RibbonDiffXml)

削除: 関連するコントロールのコレクションをリボンに表示するコントロールを指定しました。ギャラリー内のアイテムの数が多すぎる場合は、残りのコントロールをウィンドウに表示するための展開矢印が提供されます。

要素情報

XPath

 
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Gallery/GalleryButton |
//Menu/MenuSection/Gallery/GalleryButton

Schema Name

GalleryButtonType

Validation File

RibbonWSS.xsd

Can be Empty

Yes

関連項目

他のリソース

Ribbon XML reference
コマンドおよびリボンをカスタマイズする

Microsoft Dynamics CRM 2016 and Microsoft Dynamics CRM Online
Send comments about this topic to Microsoft.
© 2015 Microsoft. All rights reserved.