MiniToolbarDropdown Object


Description

The MiniToolbarDropdown object represents a dropdown control within a MiniToolbar. The pictures below illustrate various types of drop downs.

Methods

Name Description
AddItem Method that adds an item to the control.
AddSeparator Method that adds a separator to the control.
Clear Method that removes all the items from the control.
Delete Method that deletes the control.
RemoveItem Method that removes the specified item from the control.

Properties

Name Description
Application Returns the top-level parent application object. When used the context of Inventor, an Application object is returned. When used in the context of Apprentice, an ApprenticeServer object is returned.
AutoHide Read-write property that gets and sets whether the control should be automatically hidden when the user moves the cursor away from the MiniToolbar.
ControlType Read-only property that returns the control type.
Count Read-only property that returns the number of items in the dropdown.
DisplayName Read-write property that gets and sets the display name for the control.
Enabled Read-write property that gets and sets whether the control is enabled.
HasMRUBehavior Read-write property that specifies if this button displays the most recently selected item from the list.
Index Read-only property that returns the index this control is currently positioned at within the mini toolbar.
InternalName Read-only property that returns a string uniquely identifying this control within the toolbar.
IsSplitButton Read-write property that specifies if this is a split button dropdown control. If True, clicking the button will result in an OnClick event. If this property if False, clicking the button will cause the pop-up to be displayed where the user can click on an item in the list.
Item Returns the display name of the specified item from the dropdown.
LargeIcon Read-write property that gets and sets the large icon for the control.
Parent Gets the parent object from whom this object can logically be reached.
Pressed Read-write property that gets and sets whether the currently selected item is active.
SelectedIndex Read-write property that gets and sets the index of the item currently selected.
SelectedItem Returns the item currently selected. This can return Nothing in the case where nothing is selected and will always return Nothing in the case where HasMRUBehavior is False.
ShowIcon Read-write property that gets and sets whether the icon associated with the currently selected.
ShowText Read-write property that gets and sets whether the display name associated with the currently selected item should be displayed on the face of the control.
StandardIcon Read-write property that gets and sets the standard (small) icon for the control.
ToolTipText Read-write property that gets and sets the tooltip text for the control.
Type Returns an ObjectTypeEnum indicating this object's type.
Visible Read-write property that gets and sets whether the control is visible.

Events

Name Description
OnItemHoverEnd Event that is fired when the user stops hovering over an item in the drop down in the expanded state.
OnItemHoverStart Event that is fired when the user starts to hover over an item in the drop down in the expanded state.
OnItemRemove Event that is fired when the user removes an item from the dropdown.
OnPreMenuDisplay Event that is fired when the user clicks the dropdown in a way where the drop down menu will be displayed. The event is fired just before the contents of the drop down list are shown to the user, so you can dynamically modify the contents of the list. If the IsSplitButton property is True, then clicking on the arrow to the right of the button will cause this event to be fired and display the drop-down list. Clicking the button itself is result in the OnSelect event to be fired. If the IsSplitbutton property is False, clicking the button will cause this event to be fired and display the drop-down list.
OnSelect Event that is fired soon after the user changes the currently selected item using the drop down.

Accessed From

MiniToolbarControls.AddDropdown

Version

Introduced in version 2012