<ControlRef> (RibbonDiffXml)

 

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

Attribute	Description	Type	Usage
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

See Also

Ribbon XML reference
Customize commands and the ribbon