<ControlRef> (RibbonDiffXml)

Article
06/29/2017

Applies To: Dynamics CRM 2013

Specifies a placeholder for a control within a layout template.

Syntax

<ControlRef 
 DisplayMode=["Default" | "Small" | "Medium" | "Large" | "Text" | "Menu" | "Menu16" | "Menu32" | "Thin" ]
 TemplateAlias="String" 
/>

Attributes and Elements

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

Attributes

DisplayMode

Controls the mode used to display the element.

Valid Values:

Value	Description
Default	Displays the element using the default mode.
Small	Displays the element in small mode.
Medium	Displays the element in medium mode.
Large	Displays the element in large mode.
Text	Displays the element in text mode.
Menu	Displays the element like a menu.
Menu16	Displays the element in a menu with a height of 16 pixels.
Menu32	Displays the element in a menu with a height of 32 pixels.
Thin	Displays the element in thin mode.

Enumeration

Optional

TemplateAlias

Associates a ribbon element child of CommandUIDefinition with a location placeholder within a child of a Layout element. This value defines where the control will display within a group of controls when the layout changes.

String

Optional

Child Elements

This element has no child elements.

Parent Elements

Element	Description
<Row> (RibbonDiffXml)	Specifies a row within a Section.
<Strip> (RibbonDiffXml)	Contains a collection of control references.

Element Information

XPath	`//RibbonDiffXml/Templates/RibbonTemplates/GroupTemplate/Layout/Section/Row/ControlRef \| //RibbonDiffXml/Templates/RibbonTemplates/GroupTemplate/Layout/Section/Row/Strip/ControlRef`
Schema Name	ControlRefType
Validation File	RibbonWSS.xsd
Can be Empty	Yes