<Controls> (RibbonDiffXml)

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

コントロールのコレクションを格納します。

重要

The valid child elements of the Controls element depend on the parent element.

構文

    <CommandUIDefinition>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <Button /> |
        <CheckBox /> |
        <ComboBox /> |
        <ColorPicker /> |
        <ContextualGroup /> |
        <Controls /> |
        <DropDown /> |
        <FlyoutAnchor /> |
        <Gallery /> |
        <GalleryButton /> |
        <GroupTemplate /> |
        <Group /> |
        <Groups /> |
        <InsertTable /> |
        <Label /> |
        <MRUSplitButton /> |
        <MaxSize /> |
        <Menu /> |
        <MenuSection /> |
        <Scale /> |
        <Scaling /> |
        <Spinner /> |
        <SplitButton /> |
        <Tab /> |
        <TextBox/> |
        <ToggleButton />
       ]
     </Controls>
    </CommandUIDefinition>

    <MenuSection>
     <Controls
      Id="String"
      ToolTipDescription="String"
      ToolTipHelpKeyWord="String"
      ToolTipImage32by32="String"
      ToolTipImage32by32Class="String"
      ToolTipImage32by32Left="NonPositiveInteger"
      ToolTipImage32by32Top="NonPositiveInteger"
      ToolTipTitle="String">
      [ 
        <ToggleButton /> |
        <Button /> |
        <ColorPicker /> |
        <FlyoutAnchor /> |
        <InsertTable /> 
       ]
     </Controls>
    </MenuSection>

属性と要素

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

属性

Attribute	Description	Type	Usage
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
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
ToolTipSelectedItemTitle	この要素は Microsoft Dynamics CRM では使用されません。	String	Optional
ToolTipShortcutKey	この要素は Microsoft Dynamics CRM では使用されません。	String	Optional
ToolTipTitle	コントロールのツールヒントのタイトルに表示する文字列を指定します。通常、これは LabelText コントロールと同じ値です。$LocLabels: ディレクティブを使用すると、LocLabel 要素を参照できます。たとえば、"$LocLabels:MyISV.account.Save.Button.Label" のように指定します。	String	Optional

下位要素

Element	Description
<Button> (RibbonDiffXml)	アクションを実行するために使用するシンプルなボタンを指定します。
<CheckBox> (RibbonDiffXml)	オプションの選択に使用するチェック ボックスを指定します。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ColorPicker> (RibbonDiffXml)	削除: 色またはスタイルの選択に使用するグリッドを指定しました。 This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<ComboBox> (RibbonDiffXml)	削除: クリックまたは入力することによって値を選択するために使用する一覧を指定しました。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<DropDown> (RibbonDiffXml)	削除: クリックによって値を選択するために使用する一覧を指定しました。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<FlyoutAnchor> (RibbonDiffXml)	メニューを開くために使用する下矢印付きのボタンを指定します。
<GalleryButton> (RibbonDiffXml)	削除: ギャラリー要素内のボタン コントロールを指定しました。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<InsertTable> (RibbonDiffXml)	削除: テーブルのディメンションを指定するために使用する 10 x 10 のグリッドを指定しました。 This element is only valid when Controls is a child of <MenuSection> (RibbonDiffXml)
<Label> (RibbonDiffXml)	情報の提供に使用するテキスト行を指定します。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<MRUSplitButton> (RibbonDiffXml)	削除: 最近使用したアイテムを表示する分割ボタン コントロールを指定しました。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<Spinner> (RibbonDiffXml)	値を入力するか、方向キーを使用して値を切り替えることによって値を挿入するために使用するコントロールを指定します。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<SplitButton> (RibbonDiffXml)	ボタンとメニューの両方として使用するコントロールを指定します。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<TextBox> (RibbonDiffXml)	削除: テキストの入力に使用するコントロールを指定しました。 This element is only valid when Controls is a child of <CommandUIDefinition> (RibbonDiffXml).
<ToggleButton> (RibbonDiffXml)	オンとオフの状態を切り替えるために使用するボタンを指定します。

親要素

Element	Description
<Group> (RibbonDiffXml)	共通のレイアウト テンプレートを共有するタブ内のコントロールのグループを指定します。
<CommandUIDefinition> (RibbonDiffXml)	CustomAction 要素内に収まる、表示可能な Ribbon 要素を指定します。
<MenuSection> (RibbonDiffXml)	メニューの分割に使用するセクションを指定します。メニュー セクションにはタイトルとコントロールを指定できます。

要素情報

XPath	//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Controls | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/Menu/MenuSection/Controls | //RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MenuSection/Controls
Schema Name	ControlsType
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.