Difference between revisions of "RxDropDownRegular"
From Ribbon Commander Documentation
| (2 intermediate revisions by the same user not shown) | |||
| Line 3: | Line 3: | ||
[[Category:2007 Controls]] | [[Category:2007 Controls]] | ||
| − | [[image: rxDropDownRegular.png|right|link=]] | + | [[image: rxDropDownRegular.png|310px|right|link=]] |
== Description == | == Description == | ||
rxDropDownRegular models element [http://msdn.microsoft.com/en-us/library/dd949365(v=office.12).aspx CT_DropDownRegular] of the MS Custom UI XML specification which specifies a standard drop-down control which optionally has a group of buttons below its selection items. | rxDropDownRegular models element [http://msdn.microsoft.com/en-us/library/dd949365(v=office.12).aspx CT_DropDownRegular] of the MS Custom UI XML specification which specifies a standard drop-down control which optionally has a group of buttons below its selection items. | ||
| Line 54: | Line 54: | ||
{{DocTableEntry | name=getEnabled}} | {{DocTableEntry | name=getEnabled}} | ||
{{DocTableEntry | name=getImage}} | {{DocTableEntry | name=getImage}} | ||
| + | {{DocTableEntry | name=getItemCount}} | ||
| + | {{DocTableEntry | name=getItemID}} | ||
| + | {{DocTableEntry | name=getItemImage}} | ||
| + | {{DocTableEntry | name=getItemLabel}} | ||
| + | {{DocTableEntry | name=getItemScreentip}} | ||
| + | {{DocTableEntry | name=getItemSupertip}} | ||
{{DocTableEntry | name=getKeytip}} | {{DocTableEntry | name=getKeytip}} | ||
{{DocTableEntry | name=getLabel}} | {{DocTableEntry | name=getLabel}} | ||
{{DocTableEntry | name=getScreentip}} | {{DocTableEntry | name=getScreentip}} | ||
| + | {{DocTableEntry | name=getSelectedItemID}} | ||
{{DocTableEntry | name=getSelectedItemIndex}} | {{DocTableEntry | name=getSelectedItemIndex}} | ||
{{DocTableEntry | name=getShowImage}} | {{DocTableEntry | name=getShowImage}} | ||
| Line 62: | Line 69: | ||
{{DocTableEntry | name=getSupertip}} | {{DocTableEntry | name=getSupertip}} | ||
{{DocTableEntry | name=getVisible}} | {{DocTableEntry | name=getVisible}} | ||
| − | {{DocTableEntry | name= | + | {{DocTableEntry | name=onAction_dropdown}} |
{{DocTableEnd}} | {{DocTableEnd}} | ||
Latest revision as of 21:56, 13 March 2013
Contents
Description
rxDropDownRegular models element CT_DropDownRegular of the MS Custom UI XML specification which specifies a standard drop-down control which optionally has a group of buttons below its selection items.
Properties
Property Name
|
Description
|
| enabled | Whether the controls is enabled |
| id | The ID of a custom UI element. IDs must be unique |
| idMso | The ID of a built-in control |
| idQ | A qualified control ID. Qualified IDs allow different add-ins to modify the same custom group, tab, or menu |
| image | A custom image or icon |
| imageMso | The image of a built-in control |
| insertAfterMso | The ID of a built-in control to be inserted after |
| insertAfterQ | The ID of a control to be inserted after |
| insertBeforeMso | The ID of a built-in control to be inserted before |
| insertBeforeQ | The ID of control to be inserted before |
| isEmpty | Read-only property; returns true if the control is empty |
| isLive | Read-only property; returns true if the control is live |
| keytip | Sets the control's keytip |
| label | Sets the control's label |
| parent | The control's parent object |
| screentip | Sets the screentip, which appears on mouse hover |
| showImage | Whether to show a control's image |
| showItemImage | Whether owned item images are shown |
| showItemLabel | Whether owned item labels are shown |
| showLabel | Whether to show a control's label |
| sizeString | A representative string that sets the control's width |
| supertip | Sets the control's supertip, a large screentip |
| tag | Custom data |
| visible | Whether the control is visible |
| xml | Returns the xml node that corresponds to the state of the control |
Contained Controls
Property Name
|
Description
|
| buttons | A collection of buttons |
| items | The collection of items in the drop-down |
| ribbonXControls | The collection of all contained ribbonX controls |
Methods
Method Name
|
Description
|
| clear | Clears the control's state |
| clone | Creates a clone of the control (a new id is automatically created if applicable) |
| readXml | Populates the control using the passed-in XML string |
Delegates
Delegate Name
|
Description
|
| getEnabled | Callback that sets the control's enabled state |
| getImage | Callback for a custom image |
| getItemCount | Callback for the number of items in a drop-down control |
| getItemID | Callback for an item's id |
| getItemImage | Callback for an item's image |
| getItemLabel | Callback for an item's label |
| getItemScreentip | Callback for an item's screentip |
| getItemSupertip | Callback for an item's supertip |
| getKeytip | Callback that sets the keytip |
| getLabel | Callback that sets the label |
| getScreentip | Callback that sets the screentip |
| getSelectedItemID | Callback that specifies the ID of the selected item when the control is created/invalidated |
| getSelectedItemIndex | Callback that specifies the index of the selected item when the control is created/invalidated |
| getShowImage | Callback for whether to show the control's image |
| getShowLabel | Callback for whether to show the control's label |
| getSupertip | Callback that sets the supertip, a large screentip |
| getVisible | Callback that sets the control's visible state |
| onAction | Callback fired on user action |
Events
Event Name
|
Description
|
| OnActionEvent | Callback fired on user action |
| OnGetEnabled | Callback that sets the control's enabled state |
| OnGetImage | Callback for a custom image |
| OnGetKeytip | Callback that sets the keytip |
| OnGetLabel | Callback that sets the label |
| OnGetScreentip | Callback that sets the screentip |
| OnGetSelectedItemIndex | Callback that specifies the index of the selected item when the control is created/invalidated |
| OnGetShowImage | Callback for whether to show the control's image |
| OnGetShowLabel | Callback for whether to show the control's label |
| OnGetSupertip | Callback that sets the supertip, a large screentip |
| OnGetVisible | Callback that sets the control's visible state |
