Appends the contents of the toolbar definition, specified by Guid or ToolbarDef, to the toolbar control.
ERROR: Syntax information about IToolbarControlDefault.AddToolbarDef may not be in D:\ArcGIS\DotNet\ESRI.ArcGIS.Controls.dll
[C++]
HRESULT AddToolbarDef(
VARIANT ToolbarDef,
long startIndex,
VARIANT_BOOL Group,
long GroupSpacing,
esriCommandStyles Style,
long* Count
);
[C++]Parameters
ToolbarDef [in] ToolbarDef is a parameter of type VARIANT startIndex [in, optional, defaultvalue(-1)] startIndex is a parameter of type long Group [in, optional, defaultvalue(VARIANT_FALSE)] Group is a parameter of type VARIANT_BOOL GroupSpacing [in, optional, defaultvalue(4)] GroupSpacing is a parameter of type long Style [in, optional, defaultvalue(1)]Style is a parameter of type esriCommandStyles
Count [out, retval] Count is a parameter of type long
Product Availability
Description
Takes the specified toolbar definition and for each command specified an item is created and added to the ToolbarControl with an associated IToolbarItem::Command set. Specifiy the toolbar definition as either a IUid, ProgID, or IToolBarDef .
startIndex determines the position on the ToolbarControl each item will be added to. By default this is -1 and represents the end of the ToolbarControl.
Group determines whether separators will appear before the first and after the last item defined by the IToolBarDef . By default Group is False. Note this will override any IItemDef::Group property set in the IToolBarDef.
GroupSpacing determines the width of any separators, and applies to all item's defined by the IToolBarDef .
Style applies to all item's defined by the IToolBarDef. By default Style is set to esriCommandStyleIconOnly.
Where possible always supply toolbars as either Uid objects or ProgID's. Only supply toolbars as IToolBarDef objects when a IUid or ProgID does not exist, and the class is compiled as part of the same project using the ToolbarControl.
Errors Returned
1023 800A03FF: The specified index is out of range
1040 800A0410: Errors occured adding commands from toolbardef
1042 800A0412: The supplied toolbar def object is invalid or contains zero commands
Remarks
For each command specified by the IToolBarDef, AddToolbarDef calls the AddItem method which checks to see if the supplied command already exists in the CommandPool. If the command does not already exist, it is added to the CommandPool with a ICommandPool::UsageCount of 1, and is set as the IToolbarItem::Command. If the command does already exist in the CommandPool its ICommandPool::UsageCount increments by 1 and the command is set as the IToolbarItem::Command. The ICommand::OnCreate method will only be called the first time a command is added to the CommandPool.
//Add a toolbardef by passing a UID UID uID = new UIDClass(); uID.Value = "esriControls.ControlsMapNavigationToolbar"; axToolbarControl1.AddToolbarDef(uID,-1,false,0,esriCommandStyles.esriCommandStyleIconOnly); //Add a toolbardef by passing a ProgID string progID = "esriControls.ControlsMapNavigationToolbar"; axToolbarControl1.AddToolbarDef(progID,-1,false,0,esriCommandStyles.esriCommandStyleIconOnly); //Add a toolbardef by passing an IToolbarDef IToolBarDef toolBarDef = new ControlsMapNavigationToolbarClass(); axToolbarControl1.AddToolbarDef(toolBarDef,-1,false,0,esriCommandStyles.esriCommandStyleIconOnly);
'Add a toolbardef by passing a UID Dim pUid As New UIDClass pUid.Value = "esriControls.ControlsMapNavigationToolbar" AxToolbarControl1.AddToolbarDef(pUid) 'Add a toolbardef by passing a ProgID Dim sProgID As String sProgID = "esriControls.ControlsMapNavigationToolbar" AxToolbarControl1.AddToolbarDef(sProgID) 'Add a toolbardef by passing an IToolbarDef Dim pToolBarDef As IToolBarDef pToolBarDef = New ControlsMapNavigationToolbarClass AxToolbarControl1.AddToolbarDef(pToolBarDef)