<MRUSplitButton> (RibbonDiffXml)
Specifies a split button control that displays Most Recently Used items.
Important |
|---|
| This control is not supported. For information about supported controls, see Define Ribbon Controls. Consider using <SplitButton> (RibbonDiffXml) instead of this control. |
<MRUSplitButton Alt="String" CacheMenuVersions=["0" | "1" | "true" | "false"] Command="String" CommandMenuClose="String" CommandMenuOpen="Strimg" CommandPreview="String" CommandPreviewRevert="String" Id="String" InitialItem="String" MenuAlt="String" MenuCommand="String" PopulateDynamically=["0" | "1" | "true" | "false"] PopulateOnlyOnce=["0" | "1" | "true" | "false"] PopulateQueryCommand="String" QueryCommand="String" Sequence="Integer" TemplateAlias="String" ToolTipDescription="String" ToolTipHelpKeyWord="String" ToolTipImage32by32="String" ToolTipImage32by32Class="String" ToolTipImage32by32Left="Non Positive Integer" ToolTipImage32by32Top="Non Positive Integer" ToolTipSelectedItemTitle="String" ToolTipShortcutKey="String" ToolTipTitle="String" > <Menu /> </MRUSplitButton>
The following table lists the attributes, child elements, and parent elements.
Attributes
| Attribute | Description | Type | Usage | ||
|---|---|---|---|---|---|
|
Alt |
String or reference to a localized label to display as alternative text. |
String |
Optional |
||
|
CacheMenuVersions |
Indicates whether the definition for the control should be cached for better performance. Select this value if you do not select PopulateDynamically. |
Boolean Default = false. |
Optional |
||
|
Command |
Specifies the ID of the ribbon command for this control. |
String |
Optional |
||
|
CommandMenuClose |
Specifies the ID of the menu command to run when the menu closes. |
String |
Optional |
||
|
CommandMenuOpen |
Specifies the ID of the ribbon command to run when the menu opens. |
String |
Optional |
||
|
CommandPreview |
Specifies the ID of the ribbon command to run when the cursor hovers over the control before it is selected. |
String |
Optional |
||
|
CommandPreviewRevert |
Specifies the ID of the ribbon command to run when the control loses focus after preview. |
String |
Optional |
||
|
Id |
Specifies a unique identifier for the definition of a ribbon element. The strongly recommended naming convention is to use a period to separate the parts of the name like so: [solution identifier].[entity].[ribbon].[function].[element name]. For example: 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
|
String |
Required |
||
|
InitialItem |
Specifies the initial menu to display in the control. |
String |
Optional See Remarks |
||
|
MenuAlt |
Alternative text to represent the menu. |
String |
Optional |
||
|
MenuCommand |
The name of the command to execute when the menu is clicked. |
String |
Optional |
||
|
PopulateDynamically |
Specifies that the menu elements that provide options for this control will be populated dynamically at run-time using the command defined by the PopulateQueryCommand attribute. |
Boolean Default = false. |
Optional |
||
|
PopulateOnlyOnce |
When the control is populated dynamically, this setting indicates that the command defined by the PopulateQueryCommand attribute should only be called once. |
Boolean Default = false. |
Optional |
||
|
PopulateQueryCommand |
When the control is populated dynamically, this command retrieves the menu elements that provide options for this control. |
String |
Optional |
||
|
QueryCommand |
For internal use only. |
String |
Optional |
||
|
Sequence |
Specify the location of the ribbon modification by setting the Sequence value higher or lower than existing ribbon elements. |
Integer |
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 |
||
|
ToolTipDescription |
Specifies a string to display for the tooltip for a control. This can reference a LocLabel element using the $LocLabels: directive, for example, "$LocLabels:MyISV.account.Save.Button.Tooltip". |
String |
Optional |
||
|
ToolTipHelpKeyWord |
This element is not used in Microsoft Dynamics CRM. |
String |
Optional |
||
|
ToolTipImage32by32 |
Specifies a 32 by 32 pixel image to be displayed with the tooltip. |
String |
Optional |
||
|
ToolTipImage32by32Class |
Specifies a CSS class to apply to the 32 by 32 pixel image to be displayed with the tooltip. |
String |
Optional |
||
|
ToolTipImage32by32Left |
Specifies the number of pixels to move the tooltip 32 by 32 pixel image to the left. This is represented by a negative number. |
Non positive Integer |
Optional |
||
|
ToolTipImage32by32Top |
Specifies the number of pixels to move the tooltip 32 by 32 pixel image to the top. This is represented by a negative number. |
Non positive Integer |
Optional |
||
|
ToolTipSelectedItemTitle |
This element is not used in Microsoft Dynamics CRM. |
String |
Optional |
||
|
ToolTipShortcutKey |
This element is not used in Microsoft Dynamics CRM. |
String |
Optional |
||
|
ToolTipTitle |
Specifies a string to display for the title of a tooltip for a control. This is typically the same value as the control LabelText. This can reference a LocLabel element using the $LocLabels: directive, for example, "$LocLabels:MyISV.account.Save.Button.Label". |
String |
Optional |
Child Elements
| Element | Description |
|---|---|
|
Specifies a container used to show pop-up menus. |
Parent Elements
| Element | Description |
|---|---|
|
Specifies the visible Ribbon elements to be included within a CustomAction element. |
|
|
Contains a collection of controls. |
If the InitialItem attribute refers to a Id that does not exist at runtime and error will occur.
|
XPath |
//RibbonDiffXml/CustomActions/CustomAction/CommandUIDefinition/MRUSplitButton | //Controls/MRUSplitButton |
|
Schema Name |
MRUSplitButtonType |
|
Validation File |
RibbonWSS.xsd |
|
Can be Empty |
Yes |
Microsoft Dynamics CRM 2011
Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.
Important