CommandControls.AddSplitButton Method
Parent Object: CommandControlsDescription
Method that creates a new split button CommandControl object. An example of this type of control is the 'New File' split button drop down available in the Quick Access Toolbar.
Syntax
CommandControls.AddSplitButton( DisplayedControl As ButtonDefinition, ButtonDefinitions As ObjectCollection, [UseLargeIcon] As Boolean, [ShowText] As Boolean, [TargetControlInternalName] As String, [InsertBeforeTargetControl] As Boolean ) As CommandControlParameters
| Name | Type | Description |
| DisplayedControl | ButtonDefinition | Input ButtonDefinition object that specifies the default control for the control. This is the control that is always displayed to the user. |
| ButtonDefinitions | ObjectCollection | Input ObjectCollection containing the ButtonDefinition objects hosted by this control. This collection may include the displayed control, but doesn't have to. |
| UseLargeIcon | Boolean | Optional input Boolean that specifies whether to use large icon or small icon for the control. If not specified, the small icon is used by default. This is an optional argument whose default value is False. |
| ShowText | Boolean | Optional input Boolean that specifies whether to display text (display name) for the control. If not specified, text is displayed by default. This is an optional argument whose default value is True. |
| TargetControlInternalName | String | Optional input String that specifies the internal name of an existing control to position the new control next to. If specified, the InsertBeforeTargetControl argument indicates whether to place the new control before or after the target control. If not specified, the new control is positioned at the end. This is an optional argument whose default value is "". |
| InsertBeforeTargetControl | Boolean | Optional input Boolean that specifies whether to position the new control before or after the target control. The argument defaults to False and is not used if the TargetControlInternalName argument is not specified. This is an optional argument whose default value is False. |
Samples
| Name | Description |
| Create a ribbon panel in an existing tab | Demonstrates creating a new ribbon panel within an existing ribbon tab. |