This document is archived and information here might be outdated.  Recommended version.


IToolbarControlDefault Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Controls > ESRI ArcGIS Controls > Interfaces > IT > IToolbarControlDefault Interface
ArcGIS Developer Help

IToolbarControlDefault Interface

Provides access to members that control the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Description

The IToolbarControlDefault interface is the default dispatch interface that most development environments will automatically expose. For example, placing the ToolbarControl in a container will typically generate an object called ToolbarControl1. The properties and methods available directly on this object correspond to this interface, together with container specific properties and methods.

The IToolbarControlDefault interface is a 'pure' dispatch interface, so can be extended with new properties and methods at future releases of ArcGIS. The methods and properties are identical to the highest numbered main interface on the ToolbarControl. For example, IToolbarControlDefault is equivalent to IToolbarControl2, but at future releases this could become IToolbarControl3. By using the IToolbarControlDefault interface you are guaranteed to always have access to the latest ToolbarControl. 

There is a small performance overhead in making calls through to a pure dispatch interface, but to avoid this you can QI to a specific interface. In some development environments it is not possible to QI directly on the control to other COM interfaces, because the control is contained within a wrapper object. Use the Object property to get the real control before performing the QI.

Members

Name Description
Method AboutBox Displays a dialog of information about the ToolbarControl.
Method AddItem Adds an item to the ToolbarControl.
Method AddMenuItem Adds a menu item to the ToolbarControl.
Method AddToolbarDef Appends the contents of the toolbar definition, specified by Guid or ToolbarDef, to the toolbar control.
Read/write property AlignLeft Indicates if the ToolbarControl displays menu and palette items aligned to the left or right.
Read/write property Appearance The appearance of the ToolbarControl.
Read/write property BackColor Background color of the ToolbarControl.
Read/write property BorderStyle The border style of the ToolbarControl.
Read-only property Buddy The object that will have its current tool managed by the toolbar.
Read/write property CommandPool The command pool used by the ToolbarControl to manage command objects. The command pool object maybe shared with other ToolbarControls and ToolbarMenus.
Read-only property Count The number of items on the ToolbarControl.
Read/write property CurrentTool The current tool of the buddy.
Read/write property Customize Indicates if the ToolbarControl is in customize mode.
Read/write property CustomProperty A property to associate data with a control.
Read/write property Enabled Indicates whether the ToolbarControl can respond to user generated events.
Read/write property FadeColor Background fade color of the ToolbarControl.
Read/write property FillDirection The fill direction of the ToolbarControl background color.
Method Find Returns the index of the first item containing the given command, menu or palette. Returns -1 if the command is not found.
Method GetItem Returns the item at the specified index from the ToolbarControl.
Method GetItemRect Returns the dimensions of the item at the specified index.
Method HitTest Returns the index of the item at the specified x and y coordinates.
Read-only property hWnd Handle to the window associated with the ToolbarControl.
Read/write property IconSize The size in pixels of icons displayed on the ToolbarControl.
Read/write property ItemAppearance The appearance of the items on the ToolbarControl.
Read/write property KeyIntercept A property that specifies interception of key strokes that are normally handled by the container. When intercepted the OnKeyDown and OnKeyUp events will be called. This value can be a combined bit mask of esriKeyIntercept enum values.
Read/write property LargeIcons Indicates if large icons are shown on all items on the ToolbarControl.
Method LoadItems Loads items into the ToolbarControl from a previously saved stream.
Read/write property MenuTracking Indicates if menu tracking is enabled on the ToolbarControl.
Read/write property MouseIcon Custom mouse icon used if MousePointer is 99.
Read/write property MousePointer The mouse pointer displayed over the ToolbarControl.
Method MoveItem Moves an item from one index to another.
Read-only property Object A property that returns the underlying control. This can be used when the control is inside a wrapper object that has been added by a development environment.
Read/write property OperationStack The operation stack used for undo and redo functionality. If present commands can use it to store operations.
Read/write property Orientation Indicates if the ToolbarControl is horizontally or vertically aligned.
Method Remove Removes the item at the specified index from the ToolbarControl.
Method RemoveAll Removes all items from the ToolbarControl.
Method SaveItems Saves the ToolbarControl items into a stream.
Method SetBuddyControl Sets a control to be a buddy of the toolbar, this control must support IToolbarBuddy.
Read/write property ShowHiddenItems Indicates if the ToolbarControl has a hidden items menu containing items currently not visible.
Read/write property TextAlignment The caption placement for all items on the ToolbarControl.
Read/write property ThemedDrawing Indicates if the ToolbarControl uses themed drawing.
Read/write property ToolTips Indicates if the items tooltips are shown.
Read/write property Transparent Indicates if the ToolbarControl has a transparent background.
Method Update Updates the enabled state of the specified item or all items if an index of -1 is specified. Specify fullUpdate to update the group, group spacing, style and bitmap properties.
Read/write property UpdateInterval The frequency in millisecs that update method is called on the ToolbarControl.

Classes that implement IToolbarControlDefault

Classes Description
ToolbarControl Esri ToolbarControl
[C#]

When querying interface to IToolbarControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

IToolbarControlDefault toolbarControl = axToolbarControl1.Object as IToolbarControlDefault;

[Visual Basic .NET]

When querying interface to IToolbarControlDefault in Visual Basic .NET or Visual C# .NET the Object property or container specific code must be used. This is because .NET contains the real control inside a wrapper object known as an host.

Dim toolbarControl As IToolbarControlDefault = AxToolbarControl1.Object