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


IToolbarControl Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Controls)  

IToolbarControl Interface

Provides access to members that control the ToolbarControl. Note: the IToolbarControl interface has been superseded byIToolbarControl2. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine.

Description

The IToolbarControl interface is a starting point for any tasks related to the ToolBarControl such as setting the general appearance, setting the buddy control, adding and removing commands, tools, toolcontrols, menus and palettes, and customizing the contents of the ToolbarControl.

Members

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 Appearance The appearance 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.
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 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.
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.
Method Remove Removes the item at the specified index from the ToolbarControl.
Method RemoveAll Removes all items from the ToolbarControl.
Method SetBuddyControl Sets a control to be a buddy of the toolbar, this control must support IToolbarBuddy.
Read/write property TextAlignment The caption placement for all items on the ToolbarControl.
Read/write property ToolTips Indicates if the items tooltips are shown.
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.

CoClasses that implement IToolbarControl

CoClasses and Classes Description
ToolbarControl Esri ToolbarControl
[C#]

When querying interface to IToolbarControl 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.

IToolbarControl toolbarControl=axToolbarControl1.Object as IToolbarControl;

[Visual Basic .NET]

When querying interface to IToolbarControl 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 IToolbarControl=AxToolbarControl1.Object

.NET Snippets

Add Editing Commands to ToolbarControl | Create PopUp ToolbarMenu | Add ArcWeb Menu to ToolbarControl | Create PopUp ToolbarPalette | Add Page Layout Commands to ToolbarControl | Customize ToolbarControl | Add Ink Commands to ToolbarControl | Add Globe Commands to ToolbarControl | Add Map Commands to ToolbarControl | Add Schematics Commands to ToolbarControl | Add Network Analyst Commands to ToolbarControl

.NET Samples

ArcGIS Network Analyst extension Engine application (Code Files: cmdNAProperties)

.NET Related Topics

How to add a context menu using the Visual Studio Integration tools | How to use an application as the ToolbarControl buddy