<ControlRef> (RibbonDiffXml)

 

Applies To: Dynamics CRM 2015

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

© 2016 Microsoft. All rights reserved. Copyright