com.esri.arcgis.beans.toolbar
Class ToolbarBean

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              com.esri.arcgis.beans.toolbar.ToolbarBean

All Implemented Interfaces:

IToolbarItems, IToolbarControl, IToolbarControlDefault, IConnectionPointContainer, IPersistStreamInit, com.esri.arcgis.interop.RemoteObjRef, IPersist, ISupportErrorInfo, ImageObserver, MenuContainer, Serializable

public class ToolbarBean
extends JComponent
implements com.esri.arcgis.interop.RemoteObjRef, IToolbarControlDefault, IToolbarControl, IConnectionPointContainer, IPersistStreamInit, IPersist, ISupportErrorInfo, IToolbarItems

The ToolbarBean is a wrapper class of ToolbarControl to facilitate the use of ToolbarControl at the design time. Users could access the actual control by getToolbarControl method.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

protected ToolbarControl	m_toolbarControl
static ImageIcon	TOOLBARBEAN_ICON

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

ToolbarBean()
Default constructor

Method Summary

void	aboutBox() Displays a dialog of information about the ToolbarControl.
int	addItem(Object commandOrMenu, int subtype, int index, boolean beginGroup, int groupSpacing, int style) Adds an item to the ToolbarControl.
void	addIToolbarControlEventsListener(IToolbarControlEventsAdapter theListener)
int	addMenuItem(Object menu, int index, boolean beginGroup, int groupSpacing) Adds a menu item to the ToolbarControl.
int	addToolbarDef(Object toolbarDef, int startIndex, boolean group, int groupSpacing, int style) Appends the contents of the toolbar definition, specified by Guid or ToolbarDef, to the toolbar control.
void	enumConnectionPoints(IEnumConnectionPoints[] iEnumConnectionPointsArray) enumConnectionPoints
boolean	esri_isEnabled() Indicates whether the ToolbarControl can respond to user generated events.
void	esri_setEnabled(boolean rhs1) Indicates whether the ToolbarControl can respond to user generated events.
int	find(Object commandOrMenu) Returns the index of the first item containing the given command, menu or palette.
void	findConnectionPoint(GUID gUID, IConnectionPoint[] iConnectionPointArray) findConnectionPoint
int	getAppearance() The appearance of the ToolbarControl.
int	getBackColor() Background color of the ToolbarControl.
int	getBorderStyle() The border style of the ToolbarControl.
Object	getBuddy() The object that will have its current tool managed by the toolbar.
BuddyControl	getBuddyControl()
void	getClassID(GUID[] gUIDArray) getClassID
ICommandPool	getCommandPool() The command pool used by the ToolbarControl to manage command objects.
int	getCount() The number of items on the ToolbarControl.
ITool	getCurrentTool() The current tool of the buddy.
Object	getCustomProperty() A property to associate data with a control.
int	getFadeColor() Background fade color of the ToolbarControl.
int	getFillDirection() The fill direction of the ToolbarControl background color.
int	getHWnd() Handle to the window associated with the ToolbarControl.
int	getIconSize() The size in pixels of icons displayed on the ToolbarControl.
IToolbarItem	getItem(int index) Returns the item at the specified index from the ToolbarControl.
int	getItemAppearance() The appearance of the items on the ToolbarControl.
void	getItemRect(int index, int[] top, int[] left, int[] bottom, int[] right) Returns the dimensions of the item at the specified index.
String	getItemsString() Return the items String
com.esri.arcgis.interop.Dispatch	getJintegraDispatch()
int	getKeyIntercept() A property that specifies interception of key strokes that are normally handled by the container.
Picture	getMouseIcon() Custom mouse icon used if MousePointer is 99.
int	getMousePointer() The mouse pointer displayed over the ToolbarControl.
Object	getObject() A property that returns the underlying control.
IOperationStack	getOperationStack() The operation stack used for undo and redo functionality.
int	getOrientation() Indicates if the ToolbarControl is horizontally or vertically aligned.
void	getSizeMax(_ULARGE_INTEGER[] _ULARGE_INTEGERArray) getSizeMax
int	getTextAlignment() The caption placement for all items on the ToolbarControl.
ToolbarControl	getToolbarControl() Returns the actula ToolbarControl
int	getUpdateInterval() The frequency in millisecs that update method is called on the ToolbarControl.
int	hitTest(int x, int y, boolean nearest) Returns the index of the item at the specified x and y coordinates.
void	initNew() initNew
void	interfaceSupportsErrorInfo(GUID gUID) interfaceSupportsErrorInfo
boolean	isAlignLeft() Indicates if the ToolbarControl displays menu and palette items aligned to the left or right.
boolean	isCustomize() Indicates if the ToolbarControl is in customize mode.
void	isDirty() isDirty
boolean	isLargeIcons() Indicates if large icons are shown on all items on the ToolbarControl.
boolean	isMenuTracking() Indicates if menu tracking is enabled on the ToolbarControl.
boolean	isShowHiddenItems() Indicates if the ToolbarControl has a hidden items menu containing items currently not visible.
boolean	isThemedDrawing() Indicates if the ToolbarControl uses themed drawing.
boolean	isToolTips() Indicates if the items tooltips are shown.
boolean	isTransparent() Indicates if the ToolbarControl has a transparent background.
void	load(IStream pStm) load
void	loadItems(IStream iStream) Loads items into the ToolbarControl from a previously saved stream.
void	moveItem(int startIndex, int finalIndex) Moves an item from one index to another.
void	paint(Graphics g) Paints this component.
void	release()
void	removeAllItems() The method will remove all tool items in the toolbar.
void	removeIToolbarControlEventsListener(IToolbarControlEventsAdapter theListener)
void	save(IStream pStm, int fClearDirty) save
void	saveItems(IStream iStream) Saves the ToolbarControl items into a stream.
void	setAlignLeft(boolean _boolean) Indicates if the ToolbarControl displays menu and palette items aligned to the left or right.
void	setAppearance(int appearance) The appearance of the ToolbarControl.
void	setBackColor(int color) Background color of the ToolbarControl.
void	setBorderStyle(int rhs1) The border style of the ToolbarControl.
void	setBuddyControl(BuddyControl buddy)
void	setBuddyControl(Object pToolbarBuddy) Sets a control to be a buddy of the toolbar, this control must support IToolbarBuddy.
void	setCommandPoolByRef(ICommandPool rhs1) The command pool used by the ToolbarControl to manage command objects.
void	setCurrentToolByRef(ITool rhs1) The current tool of the buddy.
void	setCustomize(boolean rhs1) Indicates if the ToolbarControl is in customize mode.
void	setCustomProperty(Object rhs1) A property to associate data with a control.
void	setFadeColor(int color) Background fade color of the ToolbarControl.
void	setFillDirection(int direction) The fill direction of the ToolbarControl background color.
void	setIconSize(int size) The size in pixels of icons displayed on the ToolbarControl.
void	setItemAppearance(int itemapp) The appearance of the items on the ToolbarControl.
void	setItemsString(String items)
void	setKeyIntercept(int key) A property that specifies interception of key strokes that are normally handled by the container.
void	setLargeIcons(boolean large) Indicates if large icons are shown on all items on the ToolbarControl.
void	setLayout(LayoutManager layout) Overrides the setLayout method of super class.
void	setMenuTracking(boolean menuTracking) Indicates if menu tracking is enabled on the ToolbarControl.
void	setMouseIconByRef(Picture picture) Custom mouse icon used if MousePointer is 99.
void	setMousePointer(int pointer) The mouse pointer displayed over the ToolbarControl.
void	setOperationStackByRef(IOperationStack rhs1) The operation stack used for undo and redo functionality.
void	setOrientation(int orientation) Indicates if the ToolbarControl is horizontally or vertically aligned.
void	setShowHiddenItems(boolean _boolean) Indicates if the ToolbarControl has a hidden items menu containing items currently not visible.
void	setTextAlignment(int align) The caption placement for all items on the ToolbarControl.
void	setThemedDrawing(boolean _boolean) Indicates if the ToolbarControl uses themed drawing.
void	setToolTips(boolean tooltips) Indicates if the items tooltips are shown.
void	setTransparent(boolean _boolean) Indicates if the ToolbarControl has a transparent background.
void	setUpdateInterval(int interval) The frequency in millisecs that update method is called on the ToolbarControl.
void	update(int index, boolean fullUpdate) Updates the enabled state of the specified item or all items if an index of -1 is specified.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update, updateUI

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.esri.arcgis.controls.IToolbarControlDefault

remove, removeAll

Methods inherited from interface com.esri.arcgis.controls.IToolbarControl

remove, removeAll

Field Detail

m_toolbarControl

protected ToolbarControl m_toolbarControl

TOOLBARBEAN_ICON

public static ImageIcon TOOLBARBEAN_ICON

Constructor Detail

ToolbarBean

public ToolbarBean()

Default constructor

Method Detail

setLayout

public void setLayout(LayoutManager layout)

Overrides the setLayout method of super class.

Overrides:

setLayout in class Container

Parameters:

layout - LayoutManager - a LayoutManager object.

getToolbarControl

public ToolbarControl getToolbarControl()

Returns the actula ToolbarControl

Returns:

ToolbarControl

paint

public void paint(Graphics g)

Paints this component.

Overrides:

paint in class JComponent

Parameters:

g - the graphics context to use for painting

setItemsString

public void setItemsString(String items)

Specified by:

setItemsString in interface IToolbarItems

Parameters:

string -

getItemsString

public String getItemsString()

Return the items String

Specified by:

getItemsString in interface IToolbarItems

Returns:

String

removeAllItems

public void removeAllItems()
                    throws IOException

The method will remove all tool items in the toolbar.

Throws:

IOException

getAppearance

public int getAppearance()
                  throws IOException

The appearance of the ToolbarControl.

Description

Returns or sets the paint style of a ToolbarControl to either Flat or 3D. By default the appearance is flat.

Product Availability

Available with ArcGIS Engine.

Specified by:

getAppearance in interface IToolbarControl

Specified by:

getAppearance in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriControlsAppearance constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAppearance

public void setAppearance(int appearance)
                   throws IOException

The appearance of the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setAppearance in interface IToolbarControl

Specified by:

setAppearance in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriControlsAppearance constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBorderStyle

public int getBorderStyle()
                   throws IOException

The border style of the ToolbarControl.

Description

Returns or sets the border style of a ToolbarControl. By default a border is not drawn.

Product Availability

Available with ArcGIS Engine.

Specified by:

getBorderStyle in interface IToolbarControl

Specified by:

getBorderStyle in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriControlsBorderStyle constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBorderStyle

public void setBorderStyle(int rhs1)
                    throws IOException

The border style of the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setBorderStyle in interface IToolbarControl

Specified by:

setBorderStyle in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriControlsBorderStyle constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMousePointer

public int getMousePointer()
                    throws IOException

The mouse pointer displayed over the ToolbarControl.

Description

Use this property when you want to indicate changes in functionality as the mouse pointer passes over the ToolbarControl. The esriPointerArrowHourglass setting (11) is useful for indicating that the user should wait for a process or operation to finish.

Product Availability

Available with ArcGIS Engine.

Specified by:

getMousePointer in interface IToolbarControl

Specified by:

getMousePointer in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriControlsMousePointer constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMousePointer

public void setMousePointer(int pointer)
                     throws IOException

The mouse pointer displayed over the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setMousePointer in interface IToolbarControl

Specified by:

setMousePointer in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriControlsMousePointer constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

esri_isEnabled

public boolean esri_isEnabled()
                       throws IOException

Indicates whether the ToolbarControl can respond to user generated events.

Product Availability

Available with ArcGIS Engine.

Specified by:

esri_isEnabled in interface IToolbarControl

Specified by:

esri_isEnabled in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

esri_setEnabled

public void esri_setEnabled(boolean rhs1)
                     throws IOException

Indicates whether the ToolbarControl can respond to user generated events.

Product Availability

Available with ArcGIS Engine.

Specified by:

esri_setEnabled in interface IToolbarControl

Specified by:

esri_setEnabled in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getKeyIntercept

public int getKeyIntercept()
                    throws IOException

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.

Description

Returns or sets keys on the keyboard that will be intercepted by the ToolbarControl, triggering the OnKeyDown and OnKeyUp events when pressed. These keys are often hidden from the ToolbarControl by the development environment container. By default the KeyIntercept is set to esriKeyInterceptNone.

Many development environment containers use the up, down, left and right arrow keys to change control focus on a form. These keys can also be useful for navigating around the display. To intercept the arrow keys and the Tab key combine the enum values using a logical OR operation (esriKeyInterceptArrowKeys OR esriKeyInterceptTabKey, which is 1 OR 4 = 5).

Product Availability

Available with ArcGIS Engine.

Specified by:

getKeyIntercept in interface IToolbarControl

Specified by:

getKeyIntercept in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setKeyIntercept

public void setKeyIntercept(int key)
                     throws IOException

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.

Product Availability

Available with ArcGIS Engine.

Specified by:

setKeyIntercept in interface IToolbarControl

Specified by:

setKeyIntercept in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBuddyControl

public void setBuddyControl(BuddyControl buddy)
                     throws IOException

Throws:

IOException

getBuddyControl

public BuddyControl getBuddyControl()

setItemAppearance

public void setItemAppearance(int itemapp)
                       throws IOException

The appearance of the items on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setItemAppearance in interface IToolbarControl

Specified by:

setItemAppearance in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriControlsAppearance constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getItemAppearance

public int getItemAppearance()
                      throws IOException

The appearance of the items on the ToolbarControl.

Description

Returns or sets the paint style of each Item on the ToolbarControl to either Flat or 3D. By default the item appearance is flat.

Product Availability

Available with ArcGIS Engine.

Specified by:

getItemAppearance in interface IToolbarControl

Specified by:

getItemAppearance in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriControlsAppearance constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTextAlignment

public void setTextAlignment(int align)
                      throws IOException

The caption placement for all items on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setTextAlignment in interface IToolbarControl

Specified by:

setTextAlignment in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriToolbarTextAlignment constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTextAlignment

public int getTextAlignment()
                     throws IOException

The caption placement for all items on the ToolbarControl.

Description

Returns or sets whether each item on the ToolbarControl will display the ICommand::Caption property aligned to the right or to the bottom of the item. By default the captions will be aligned to the right of items.

Remarks

Captions are only displayed for those items with IToolbarItem::Style set to esriCommandStyleTextOnly or esriCommandStyleIconAndText.

Product Availability

Available with ArcGIS Engine.

Specified by:

getTextAlignment in interface IToolbarControl

Specified by:

getTextAlignment in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriToolbarTextAlignment constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUpdateInterval

public void setUpdateInterval(int interval)
                       throws IOException

The frequency in millisecs that update method is called on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setUpdateInterval in interface IToolbarControl

Specified by:

setUpdateInterval in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUpdateInterval

public int getUpdateInterval()
                      throws IOException

The frequency in millisecs that update method is called on the ToolbarControl.

Description

Specifies the frequency the ToolbarControl automatically calls the Update method (without a full update). Setting the UpdateInterval to 0 will stop the Update method been called automatically. By default the UpdateInterval is set to 500 milliseconds.

Remarks

Be aware that setting a small UpdateInterval may cause memory usage to increase and the system to become busy doing continual updates.

Product Availability

Available with ArcGIS Engine.

Specified by:

getUpdateInterval in interface IToolbarControl

Specified by:

getUpdateInterval in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setLargeIcons

public void setLargeIcons(boolean large)
                   throws IOException

Indicates if large icons are shown on all items on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setLargeIcons in interface IToolbarControl

Specified by:

setLargeIcons in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isLargeIcons

public boolean isLargeIcons()
                     throws IOException

Indicates if large icons are shown on all items on the ToolbarControl.

Description

Determines whether each item on the ToolbarControl will display the ICommand::Bitmap property stretched to 32 x 32 pixels. This property is false by default and bitmaps are stretched to 16 x 16 pixels.

Remarks

When the IconSize property to set to a size => 32, LargeIcons returns true.

Product Availability

Available with ArcGIS Engine.

Specified by:

isLargeIcons in interface IToolbarControl

Specified by:

isLargeIcons in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setToolTips

public void setToolTips(boolean tooltips)
                 throws IOException

Indicates if the items tooltips are shown.

Product Availability

Available with ArcGIS Engine.

Specified by:

setToolTips in interface IToolbarControl

Specified by:

setToolTips in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isToolTips

public boolean isToolTips()
                   throws IOException

Indicates if the items tooltips are shown.

Description

Determines whether each item on the ToolbarControl will display the ICommand::Tooltip property when the mouse cursor is held over the item. This property is true by default.

Product Availability

Available with ArcGIS Engine.

Specified by:

isToolTips in interface IToolbarControl

Specified by:

isToolTips in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMenuTracking

public void setMenuTracking(boolean menuTracking)
                     throws IOException

Indicates if menu tracking is enabled on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setMenuTracking in interface IToolbarControl

Specified by:

setMenuTracking in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isMenuTracking

public boolean isMenuTracking()
                       throws IOException

Indicates if menu tracking is enabled on the ToolbarControl.

Description

Indicates whether a menu or palette on the ToolbarControl will display automatically as the user moves the mouse over it, or whether the user must click on the arrow to the right of the menu or palette to display it.

An application's main menu toolbar would typically contain menu only items such as File, Edit, View and Help and would typically have MenuTracking enabled.

Product Availability

Available with ArcGIS Engine.

Specified by:

isMenuTracking in interface IToolbarControl

Specified by:

isMenuTracking in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addItem

public int addItem(Object commandOrMenu,
                   int subtype,
                   int index,
                   boolean beginGroup,
                   int groupSpacing,
                   int style)
            throws IOException,
                   AutomationException

Adds an item to the ToolbarControl.

Description

Takes the specified command and creates a new item that is added to the ToolbarControl with its Command or Menu or Palette set, and returns the index of the first item added. Specifiy the command, menu or palette as either a IUid, ProgID, ICommand, IMenuDef, IToolbarMenu, IPaletteDef or IToolbarPalette. AddItem supports the following objects: ICommand, IMenuDef, IToolbarMenu, ICommandSubType, ITool, IToolControl, IPaletteDef and IToolbarPalette. Visually items are represented on the ToolbarControl as buttons, tools, menus, text boxes and combo boxes.

Supply a subType when passing an ICommandSubType. If no subType is supplied and the command is passed as a IUid or ProgID then ICommandSubType::GetCount determines the number of Item's to be added to the ToolbarControl. A subType must be supplied when passing an ICommandSubType as an ICommand, or the method will fail. By default subType is 0.

Index determines the position on the ToolbarControl that the item will be added to. By default this is -1 and represents the end of the ToolbarControl.

beginGroup determines whether a separator will appear before the item. By default beginGroup is False.

GroupSpacing determines the width in pixels of the separator.

Style determines the sytle of the item. By default Style is set to esriCommandStyleIconOnly.

Remarks

AddItem checks to see if the supplied command already exists in the CommandPool used by the ToolbarControl. If the command does not already exist, it is created and added to the CommandPool with a ICommandPool::UsageCount of 1, and is set as the IToolbarItem::Command. If the command already exists in the CommandPool, then the command instance is reused, its ICommandPool::UsageCount is incremented by 1 and the command is set as the IToolbarItem::Command. The ICommand::OnCreate method will be called the first time a command is added to the CommandPool.

Where possible always supply commands, menus and palettes as either Uid objects or ProgID's. Only supply commands as ICommand, IMenuDef or IPaletteDef objects when a IUid or ProgID does not exist, and the class is compiled as part of the same project using the ToolbarControl. Passing a command menu or palette as an ICommand, IMenuDef or IPaletteDef object has the following limitation: Multiple instances of the same command can be added to the CommandPool, and each IToolbarItem::Command will point to a different command object. For example, setting a command implementing the ITool interface to be the CurrentTool would result in only one item appearing visually pressed on the on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

addItem in interface IToolbarControl

Specified by:

addItem in interface IToolbarControlDefault

Parameters:

item - A Variant (in)

subType - The subType (in, optional, pass 0 if not required)

index - The index (in, optional, pass -1 if not required)

beginGroup - The beginGroup (in, optional, pass false if not required)

groupSpacing - The groupSpacing (in, optional, pass 0 if not required)

style - A com.esri.arcgis.systemUI.esriCommandStyles constant (in, optional, pass 1 if not required)

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addIToolbarControlEventsListener

public void addIToolbarControlEventsListener(IToolbarControlEventsAdapter theListener)
                                      throws IOException

Throws:

IOException

removeIToolbarControlEventsListener

public void removeIToolbarControlEventsListener(IToolbarControlEventsAdapter theListener)
                                         throws IOException

Throws:

IOException

getItem

public IToolbarItem getItem(int index)
                     throws IOException,
                            AutomationException

Returns the item at the specified index from the ToolbarControl.

Description

The property is used to access a particular item on the ToolbarControl. The item at the beginning of the collection to the left of the ToolbarControl has an index of 0. Visually items are represented on the ToolbarControl as buttons, tools, menus, text boxes and combo boxes.


Remarks

To loop through a ToolBarControl's item collection use the GetItem property in conjunction with the Count property.

Product Availability

Available with ArcGIS Engine.

Specified by:

getItem in interface IToolbarControl

Specified by:

getItem in interface IToolbarControlDefault

Parameters:

index - The index (in)

Returns:

A reference to a com.esri.arcgis.controls.IToolbarItem

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCount

public int getCount()
             throws IOException,
                    AutomationException

The number of items on the ToolbarControl.

Description

Returns the number of items on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

getCount in interface IToolbarControl

Specified by:

getCount in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

update

public void update(int index,
                   boolean fullUpdate)
            throws IOException,
                   AutomationException

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.

Description

The primary job of the Update method is to ensure that each item on the ToolbarControl is synchronised with the ICommand properties of the IToolbarItem::Command.

By default the index argument is -1, and each item on the ToolbarControl is updated. To update a specific item, specifiy its index. The item at the beginning of the collection to the left of the ToolbarControl has an index of 0.

By default the fullUpdate argument is false, and each item is updated to reflect its ICommand::Enabled, ICommand::Caption and ICommand::Checked properties. Pass true to Update to additionally update the following properties: ICommand::Bitmap, IToolbarItem::Style, IToolbarItem::Group and IToolbarItem::GroupSpacing properties.

By default the Update method is called automatically on a regular interval specified by the UpdateInterval to ensure that the ToolbarControl items reflect the current application state. This updates all items, but with a fullUpdate argument set to false.

Remarks

The Update method checks each commands ICommandPool::Created property. If the command has not been created the ICommandPoolEdit::Hook property is passed into the ICommand::OnCreate method. The hook it typically the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

update in interface IToolbarControl

Specified by:

update in interface IToolbarControlDefault

Parameters:

index - The index (in, optional, pass -1 if not required)

fullUpdate - The fullUpdate (in, optional, pass false if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBuddy

public Object getBuddy()
                throws IOException,
                       AutomationException

The object that will have its current tool managed by the toolbar.

Description

The Buddy returns the object implementing IToolbarBuddy that was passed to the SetBuddyControl method. The Buddy is responsible for handling the CurrentTool.

The SetBuddyControl method will remove any wrapper object that a development environment has added to the control passed to it. As such, the object passed into the SetBuddyControl method may be different from the object returned by the Buddy.

Remarks

When an application is first started the Buddy may return Nothing until the first Update has happened. By default the Update method will be first called internally after an UpdateInterval (the default is 500 milliseconds). To avoid this delay call Update within the form load event.

Product Availability

Available with ArcGIS Engine.

Specified by:

getBuddy in interface IToolbarControl

Specified by:

getBuddy in interface IToolbarControlDefault

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCurrentTool

public ITool getCurrentTool()
                     throws IOException,
                            AutomationException

The current tool of the buddy.

Description

This is a shortcut to the CurrentTool of the Buddy. The Buddy implements the IToolbarBuddy interface that has a CurrentTool property. If no Buddy is set the CurrentTool returns Nothing.

On a ToolbarControl there is only ever one CurrentTool, and this is the item that appears 'pushed in'. If another tool is selected it becomes the new CurrentTool and the previous tool is deactivated.

If multiple ToolbarControls share the same CommandPool and have the same Buddy the CurrentTool is synchronised through the Buddy so only one item on all the ToolbarControl's will be the CurrentTool.

Remarks

Always check that the Buddy has been set, before setting the CurrentTool or the method will fail.

When the CurrentTool is set the following events occur:

1. The ITool::Deactivate event is triggered on the 'old' CurrentTool if one was set. If this event returns false a trappable error ocurrs. If this event returns true the 'old' CurrentTool is removed and replaced.
2. The ICommand::OnClick event is triggered on the 'new' CurrentTool and its cursor is picked up.

Within an ITool implementation it is recommended that the ITool::Deactivate event returns true. This allows a 'new' CurrentTool to be set, and allows the release of the CurrentTool when an application is shutting down.

Product Availability

Available with ArcGIS Engine.

Specified by:

getCurrentTool in interface IToolbarControl

Specified by:

getCurrentTool in interface IToolbarControlDefault

Returns:

A reference to a com.esri.arcgis.systemUI.ITool

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getObject

public Object getObject()
                 throws IOException,
                        AutomationException

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.

Description

In some development environments it is not possible to query interface directly on the control to other COM interfaces, beacuse the control is contained within a wrapper object. To get the real control use the Object property.

Product Availability

Available with ArcGIS Engine.

Specified by:

getObject in interface IToolbarControl

Specified by:

getObject in interface IToolbarControlDefault

Returns:

A reference to another Automation Object (IDispatch)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getHWnd

public int getHWnd()
            throws IOException,
                   AutomationException

Handle to the window associated with the ToolbarControl.

Description

The operating environment identifies each window, form and control in an application by assigning it a handle, or hWnd. Many ArcObjects methods and Windows API calls require the hWnd as an argument.

Product Availability

Available with ArcGIS Engine.

Specified by:

getHWnd in interface IToolbarControl

Specified by:

getHWnd in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCurrentToolByRef

public void setCurrentToolByRef(ITool rhs1)
                         throws IOException,
                                AutomationException

The current tool of the buddy.

Product Availability

Available with ArcGIS Engine.

Specified by:

setCurrentToolByRef in interface IToolbarControl

Specified by:

setCurrentToolByRef in interface IToolbarControlDefault

Parameters:

rhs1 - A reference to a com.esri.arcgis.systemUI.ITool (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

find

public int find(Object commandOrMenu)
         throws IOException,
                AutomationException

Returns the index of the first item containing the given command, menu or palette. Returns -1 if the command is not found.

Description

Returns the index of the first item on the ToolbarControl using the specified IUid , ProgID, ICommand, IMenuDef or IPaletteDef. If the specified command or menu cannot be found -1 is returned.

Remarks

To find an item using a Command implementing ICommandSubType pass a UID with its SubType property set.

Product Availability

Available with ArcGIS Engine.

Specified by:

find in interface IToolbarControl

Specified by:

find in interface IToolbarControlDefault

Parameters:

item - A Variant (in)

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCommandPool

public ICommandPool getCommandPool()
                            throws IOException,
                                   AutomationException

The command pool used by the ToolbarControl to manage command objects. The command pool object maybe shared with other ToolbarControls and ToolbarMenus.

Description

The CommandPool manages the collection of commands used by the ToolbarControl. The AddItem, AddToolbarDef, Remove and RemoveAll methods all use the CommandPool.

Care must be taken by developers when using the CommandPool to ensure that the ICommandPool::UsageCount of any commands in the collection stay synchronised with the number of items using the command as the IToolbarItem::Command .

Note that if a new CommandPool is set commands are copied from the original CommandPool into the new one. If the same command exists in the original CommadPool and the new CommandPool, the command in the new CommandPool is used.

Product Availability

Available with ArcGIS Engine.

Specified by:

getCommandPool in interface IToolbarControl

Specified by:

getCommandPool in interface IToolbarControlDefault

Returns:

A reference to a com.esri.arcgis.controls.ICommandPool

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCommandPoolByRef

public void setCommandPoolByRef(ICommandPool rhs1)
                         throws IOException,
                                AutomationException

The command pool used by the ToolbarControl to manage command objects. The command pool object maybe shared with other ToolbarControls and ToolbarMenus.

Product Availability

Available with ArcGIS Engine.

Specified by:

setCommandPoolByRef in interface IToolbarControl

Specified by:

setCommandPoolByRef in interface IToolbarControlDefault

Parameters:

rhs1 - A reference to a com.esri.arcgis.controls.ICommandPool (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addToolbarDef

public int addToolbarDef(Object toolbarDef,
                         int startIndex,
                         boolean group,
                         int groupSpacing,
                         int style)
                  throws IOException,
                         AutomationException

Appends the contents of the toolbar definition, specified by Guid or ToolbarDef, to the toolbar control.

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 items defined by the IToolBarDef .

Style applies to all items 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.

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.

Product Availability

Available with ArcGIS Engine.

Specified by:

addToolbarDef in interface IToolbarControl

Specified by:

addToolbarDef in interface IToolbarControlDefault

Parameters:

toolbarDef - A Variant (in)

startIndex - The startIndex (in, optional, pass -1 if not required)

group - The group (in, optional, pass false if not required)

groupSpacing - The groupSpacing (in, optional, pass 4 if not required)

style - A com.esri.arcgis.systemUI.esriCommandStyles constant (in, optional, pass 1 if not required)

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isCustomize

public boolean isCustomize()
                    throws IOException,
                           AutomationException

Indicates if the ToolbarControl is in customize mode.

Description

Use this property to determine whether the ToolbarControl is in customize mode at run time. This property is false by default. The behaviour of ToolbarControl changes when in customize mode.

Use the left mouse button to select an item on the ToolbarControl. Either drag the selected item to a new position on the ToolbarControl as indicated by the black verticle line, or drag and drop the item off the ToolbarControl to remove it.

Use the right mouse button to select an item and display the customize menu. Use the customize menu to either delete the item or set its Style, Group or GroupSpacing properties.

If the CustomizeDialog is displayed on the screen whilst the ToolbarControl is in customize mode, new items can be added to the ToolbarControl by either double clicking on an item in the CustomizeDialog or by dragging and dropping an item from the CustomizeDialog to the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

isCustomize in interface IToolbarControl

Specified by:

isCustomize in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCustomize

public void setCustomize(boolean rhs1)
                  throws IOException,
                         AutomationException

Indicates if the ToolbarControl is in customize mode.

Product Availability

Available with ArcGIS Engine.

Specified by:

setCustomize in interface IToolbarControl

Specified by:

setCustomize in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

hitTest

public int hitTest(int x,
                   int y,
                   boolean nearest)
            throws IOException,
                   AutomationException

Returns the index of the item at the specified x and y coordinates.

Description

Returns the index of the item at the specified x and y coordinates (in pixels). If no item is found, returns -1.

nearest specifies whether the index of the item nearest to the specified x and y coordinates is returned. By default nearest is false.

Product Availability

Available with ArcGIS Engine.

Specified by:

hitTest in interface IToolbarControl

Specified by:

hitTest in interface IToolbarControlDefault

Parameters:

x - The x (in)

y - The y (in)

nearest - The nearest (in, optional, pass false if not required)

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

moveItem

public void moveItem(int startIndex,
                     int finalIndex)
              throws IOException,
                     AutomationException

Moves an item from one index to another.

Description

Moves the item at the specified startIndex, to the position at the specified finalIndex. If no finalIndex is supplied the item is moved to the end of the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

moveItem in interface IToolbarControl

Specified by:

moveItem in interface IToolbarControlDefault

Parameters:

startIndex - The startIndex (in)

finalIndex - The finalIndex (in, optional, pass -1 if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getItemRect

public void getItemRect(int index,
                        int[] top,
                        int[] left,
                        int[] bottom,
                        int[] right)
                 throws IOException,
                        AutomationException

Returns the dimensions of the item at the specified index.

Description

Returns the dimensions in pixels of the item at the specified index on the ToolbarControl. An item's rectangle refers to the area on the ToolbarControl occupied by the button, text box or combo box. These rectangles are adjacent. For example, if the first item had a left value of 2, and a right value of 26, the second item would have a left value of 26.

Product Availability

Available with ArcGIS Engine.

Specified by:

getItemRect in interface IToolbarControl

Specified by:

getItemRect in interface IToolbarControlDefault

Parameters:

index - The index (in)

top - The top (in/out: use single element array)

left - The left (in/out: use single element array)

bottom - The bottom (in/out: use single element array)

right - The right (in/out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getOperationStack

public IOperationStack getOperationStack()
                                  throws IOException,
                                         AutomationException

The operation stack used for undo and redo functionality. If present commands can use it to store operations.

Description

The OperationStack used to manage undo and redo functionality. Operations are added to the operation stack by each item's Command, so that the operation can be rolled forward and then rolled back as desired. For example, when a graphic element is moved, the operation can be undone moving the graphic back to its original location.

By default the OperationStack will return Nothing. Typically, a developer creates a ControlsOperationStack and sets it into the ToolbarControl. 'Undo' and 'Redo' commands can be added to the ToolbarControl to step through the OperationStack.

Whether or not a command makes use of an OperationStack depends upon its implementation. For example, a command to nudge the position of a graphic element will create an object implementing IOperation and add it to the OperationStack using IOperationStack::Do.

Note, that commands that change the IActiveView::Extent do not need to implement an IOperation object, as the extent is automatically stored in the IActiveView::ExtentStack.

Product Availability

Available with ArcGIS Engine.

Specified by:

getOperationStack in interface IToolbarControl

Specified by:

getOperationStack in interface IToolbarControlDefault

Returns:

A reference to a com.esri.arcgis.systemUI.IOperationStack

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setOperationStackByRef

public void setOperationStackByRef(IOperationStack rhs1)
                            throws IOException,
                                   AutomationException

The operation stack used for undo and redo functionality. If present commands can use it to store operations.

Product Availability

Available with ArcGIS Engine.

Specified by:

setOperationStackByRef in interface IToolbarControl

Specified by:

setOperationStackByRef in interface IToolbarControlDefault

Parameters:

rhs1 - A reference to a com.esri.arcgis.systemUI.IOperationStack (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getCustomProperty

public Object getCustomProperty()
                         throws IOException,
                                AutomationException

A property to associate data with a control.

Description

Use the CustomProperty to associate any useful data with the ToolbarControl. This is similar to a 'Tag' property, and can be use to store strings, numbers and objects.

Product Availability

Available with ArcGIS Engine.

Specified by:

getCustomProperty in interface IToolbarControl

Specified by:

getCustomProperty in interface IToolbarControlDefault

Returns:

A Variant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCustomProperty

public void setCustomProperty(Object rhs1)
                       throws IOException,
                              AutomationException

A property to associate data with a control.

Product Availability

Available with ArcGIS Engine.

Specified by:

setCustomProperty in interface IToolbarControl

Specified by:

setCustomProperty in interface IToolbarControlDefault

Parameters:

rhs1 - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBuddyControl

public void setBuddyControl(Object pToolbarBuddy)
                     throws IOException,
                            AutomationException

Sets a control to be a buddy of the toolbar, this control must support IToolbarBuddy.

Description

Pass the SetBuddyControl method a MapControl, PageLayoutControl, SceneControl, GlobeControl or object implementing IToolbarBuddy. To clear the Buddy set the property to Nothing.

The ToolbarControl is passed as the hook parameter to the ICommand::OnCreate method of each item's command on the ToolbarControl. Each command will typically check the type of Buddy that has been set before becoming enabled. For example, a 'map zoom in' tool will only become enabled if the Buddy is a control that has a Map object ie. a MapControl or PageLayoutControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setBuddyControl in interface IToolbarControl

Specified by:

setBuddyControl in interface IToolbarControlDefault

Parameters:

pToolbarBuddy - A reference to another Automation Object (IDispatch) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addMenuItem

public int addMenuItem(Object menu,
                       int index,
                       boolean beginGroup,
                       int groupSpacing)
                throws IOException,
                       AutomationException

Adds a menu item to the ToolbarControl.

Description

Takes the specified menu and creates a new item that is added to the ToolbarControl and returns the index of the menu item added. This is really a shortcut to AddItem.

Specifiy the menu as either a IUID , ProgID, IMenuDef or IToolbarMenu.

If AddIMenuItem is passed an IMenuDef, the menu definition is is used to build a new ToolbarMenu, and the IToolbarMenu::CommandPool is set to the IToolbarControlDefault::CommandPool. If AddMenuItem is passed an IToolbarMenu a new ToolbarItem is created and the IToolbarItem::Menu is set to the IToolbarMenu.

index determines the position on the ToolbarControl that the Item will be added to. By default this is -1 and represents the end of the ToolbarControl.

beginGroup determines whether a separator will appear before the Item. By default beginGroup is False.

GroupSpacing determines the width in pixels of the separator.

Remarks

AddItem checks to see if each command in the menu already exists in the CommandPool used by the ToolbarControl. If the command does not already exist, it is created and added to the CommandPool with a ICommandPool::UsageCount of 1. If the command already exists in the CommandPool its ICommandPool::UsageCount is incremented by 1. The ICommand::OnCreate method will be called the first time a command is added to the CommandPool.

Where possible always supply menus as either Uid objects or ProgID's. Only supply menu as IMenuDef objects when a IUid or ProgID does not exist, and the class is compiled as part of the same project using the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

addMenuItem in interface IToolbarControl

Specified by:

addMenuItem in interface IToolbarControlDefault

Parameters:

menu - A Variant (in)

index - The index (in, optional, pass -1 if not required)

beginGroup - The beginGroup (in, optional, pass false if not required)

groupSpacing - The groupSpacing (in, optional, pass 4 if not required)

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

load

public void load(IStream pStm)
          throws IOException,
                 AutomationException

load

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

load in interface IPersistStreamInit

Parameters:

pStm - A reference to a com.esri.arcgis.system.IStream (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

save

public void save(IStream pStm,
                 int fClearDirty)
          throws IOException,
                 AutomationException

save

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

save in interface IPersistStreamInit

Parameters:

pStm - A reference to a com.esri.arcgis.system.IStream (in)

fClearDirty - The fClearDirty (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()

Specified by:

getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

release

public void release()

Specified by:

release in interface com.esri.arcgis.interop.RemoteObjRef

setMouseIconByRef

public void setMouseIconByRef(Picture picture)
                       throws IOException,
                              AutomationException

Custom mouse icon used if MousePointer is 99.

Product Availability

Available with ArcGIS Engine.

Specified by:

setMouseIconByRef in interface IToolbarControl

Specified by:

setMouseIconByRef in interface IToolbarControlDefault

Parameters:

rhs1 - A reference to a com.esri.arcgis.support.ms.stdole.Picture (A com.esri.arcgis.support.ms.stdole.Picture COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMouseIcon

public Picture getMouseIcon()
                     throws IOException,
                            AutomationException

Custom mouse icon used if MousePointer is 99.

Description

The MouseIcon property provides a custom icon that is used when the MousePointer property is set to esriPointerArrowHourglass (99).

Dim pToolbarControl As IToolbarControlDefault

pToolbarControl = AxToolbarControl1.Object

Dim pIcon As Icon

pIcon = New Icon(GetType(Form1).Assembly.GetManifestResourceStream(GetType(Form1), "myIcon.ico"))

pToolbarControl.MouseIcon = ESRI.ArcGIS.Utility.COMSupport.OLE.GetIPictureDispFromIcon(pIcon)

pToolbarControl.MousePointer = esriControlsMousePointer.esriPointerCustom

Remarks

In most development evironments the control's property pages can be used to load either a cursor (.cur) or icon (.ico) file. A cursor contains a custom 'hotspot' location and can be any size. The 'hotspot' location for an icon file defaults to the center of the icon. This property cannot be used to load animated cursor (.ani) files.

To programatically create an object implementing IPictureDisp there is the win32 function OleLoadPicture or helper methods depending on the development environment.

Product Availability

Available with ArcGIS Engine.

Specified by:

getMouseIcon in interface IToolbarControl

Specified by:

getMouseIcon in interface IToolbarControlDefault

Returns:

A reference to a com.esri.arcgis.support.ms.stdole.Picture (A com.esri.arcgis.support.ms.stdole.Picture COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

aboutBox

public void aboutBox()
              throws IOException,
                     AutomationException

Displays a dialog of information about the ToolbarControl.

Description

The AboutBox method causes a modal dialog box to display on top of the ToolbarControl, containing information about the version and creation date of the ToolbarControl as well as listing relevant legal and copyright information from ESRI.

Product Availability

Available with ArcGIS Engine.

Specified by:

aboutBox in interface IToolbarControl

Specified by:

aboutBox in interface IToolbarControlDefault

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

enumConnectionPoints

public void enumConnectionPoints(IEnumConnectionPoints[] iEnumConnectionPointsArray)
                          throws IOException,
                                 AutomationException

enumConnectionPoints

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

enumConnectionPoints in interface IConnectionPointContainer

Parameters:

ppEnum - A reference to a com.esri.arcgis.display.IEnumConnectionPoints (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

findConnectionPoint

public void findConnectionPoint(GUID gUID,
                                IConnectionPoint[] iConnectionPointArray)
                         throws IOException,
                                AutomationException

findConnectionPoint

Description

IConnectionPointContainer is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

findConnectionPoint in interface IConnectionPointContainer

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

ppCP - A reference to a com.esri.arcgis.display.IConnectionPoint (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getClassID

public void getClassID(GUID[] gUIDArray)
                throws IOException,
                       AutomationException

getClassID

Description

IPersist is a Microsoft interface. Please refer to MSDN for information about this interface.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getClassID in interface IPersist

Parameters:

pClassID - A Structure: com.esri.arcgis.support.ms.stdole.GUID (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isDirty

public void isDirty()
             throws IOException,
                    AutomationException

isDirty

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

isDirty in interface IPersistStreamInit

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSizeMax

public void getSizeMax(_ULARGE_INTEGER[] _ULARGE_INTEGERArray)
                throws IOException,
                       AutomationException

getSizeMax

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

getSizeMax in interface IPersistStreamInit

Parameters:

pCbSize - A Structure: com.esri.arcgis.system._ULARGE_INTEGER (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

initNew

public void initNew()
             throws IOException,
                    AutomationException

initNew

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

initNew in interface IPersistStreamInit

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID gUID)
                                throws IOException,
                                       AutomationException

interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Specified by:

interfaceSupportsErrorInfo in interface ISupportErrorInfo

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setBackColor

public void setBackColor(int color)
                  throws IOException,
                         AutomationException

Background color of the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setBackColor in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (A COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getBackColor

public int getBackColor()
                 throws IOException,
                        AutomationException

Background color of the ToolbarControl.

Description

Returns or sets the background color of the ToolbarControl. By default BackColor is set to the Windows System '3D Objects' color. Internally the OLE_Color is stored as a long integer where the value may be calculated for any RGB combination as follows:

OLE_Color = (Red) + (Green * 256) + (Blue * 256 * 256)

Where Red, Green and Blue are Long Integers within the range 0 - 255.

If the BackColor is different to the FadeColor the ToolbarControl background will be shaded between the BackColor and FadeColor by the FillDirection.

Remarks

The BackColor, FadeColor and FillDirection properties do not affect the visual appearance of the ToolbarControl when Transparent is set to true.

When ThemedDrawing is false the background color of any items on the ToolbarControl is an alpha blend of the BackColor and the Windows System '3D Highlight' color. When ThemedDrawing is true the system controls the background color.

Product Availability

Available with ArcGIS Engine.

Specified by:

getBackColor in interface IToolbarControlDefault

Returns:

The returnValue (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getOrientation

public int getOrientation()
                   throws IOException,
                          AutomationException

Indicates if the ToolbarControl is horizontally or vertically aligned.

Description

Returns or sets the orientation of a ToolbarControl. By default the orientation is horizontal.

Remarks

When a ToolControl is added to a ToolbarControl with a vertical orientation, the ToolControl displays as a button. Clicking the button displays the ToolControl in a seperate window. The ToolControl window can be closed interactively by the end user, or programmatically using the ICompletionNotify::SetComplete method.

Product Availability

Available with ArcGIS Engine.

Specified by:

getOrientation in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriToolbarOrientation constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setOrientation

public void setOrientation(int orientation)
                    throws IOException,
                           AutomationException

Indicates if the ToolbarControl is horizontally or vertically aligned.

Product Availability

Available with ArcGIS Engine.

Specified by:

setOrientation in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriToolbarOrientation constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isThemedDrawing

public boolean isThemedDrawing()
                        throws IOException,
                               AutomationException

Indicates if the ToolbarControl uses themed drawing.

Description

Determines whether items on the ToolbarControl display themselves using the current Windows XP theme. This property is false by default, and items display themselves on the ToolbarControl with the Windows Classic look.

Product Availability

Available with ArcGIS Engine.

Specified by:

isThemedDrawing in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setThemedDrawing

public void setThemedDrawing(boolean _boolean)
                      throws IOException,
                             AutomationException

Indicates if the ToolbarControl uses themed drawing.

Product Availability

Available with ArcGIS Engine.

Specified by:

setThemedDrawing in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFadeColor

public int getFadeColor()
                 throws IOException,
                        AutomationException

Background fade color of the ToolbarControl.

Description

Returns or sets the fade color of the ToolbarControl. By default FadeColor is set to the Windows System '3D Objects' color. Internally the OLE_Color is stored as a long integer where the value may be calculated for any RGB combination as follows:

OLE_Color = (Red) + (Green * 256) + (Blue * 256 * 256)

Where Red, Green and Blue are Long Integers within the range 0 - 255.

If the FadeColor is different to the BackColor the ToolbarControl background will be shaded between the BackColor and FadeColor by the FillDirection.

Remarks

The BackColor, FadeColor and FillDirection properties do not affect the visual appearance of the ToolbarControl when Transparent is set to true.

When ThemedDrawing is false the background color of any items on the ToolbarControl is an alpha blend of the BackColor and the Windows System '3D Highlight' color. When ThemedDrawing is true the system controls the background color.

Product Availability

Available with ArcGIS Engine.

Specified by:

getFadeColor in interface IToolbarControlDefault

Returns:

The returnValue (A COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setFadeColor

public void setFadeColor(int color)
                  throws IOException,
                         AutomationException

Background fade color of the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

This method is not supported on Unix.

Specified by:

setFadeColor in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (A COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getFillDirection

public int getFillDirection()
                     throws IOException,
                            AutomationException

The fill direction of the ToolbarControl background color.

Description

Returns or sets the fill direction used to shade the background color of the ToolbarControl between the BackColor and FadeColor. By default a horizontal fill direction will be set.

Remarks

The BackColor, FadeColor and FillDirection properties do not affect the visual appearance of the ToolbarControl when Transparent is set to true.

When ThemedDrawing is false the background color of any items on the ToolbarControl is an alpha blend of the BackColor and the Windows System '3D Highlight' color. When ThemedDrawing is true the system controls the background color.

Product Availability

Available with ArcGIS Engine.

Specified by:

getFillDirection in interface IToolbarControlDefault

Returns:

A com.esri.arcgis.controls.esriToolbarFillDirection constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setFillDirection

public void setFillDirection(int direction)
                      throws IOException,
                             AutomationException

The fill direction of the ToolbarControl background color.

Product Availability

Available with ArcGIS Engine.

This method is not supported on Unix.

Specified by:

setFillDirection in interface IToolbarControlDefault

Parameters:

rhs1 - A com.esri.arcgis.controls.esriToolbarFillDirection constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isTransparent

public boolean isTransparent()
                      throws IOException,
                             AutomationException

Indicates if the ToolbarControl has a transparent background.

Description

Determines whether the background of the ToolbarControl is transparent. This property is false by default.

When Transparent is true, the parent window containing the ToolbarControl must not clip children windows for transparency to work. This ensures the area of the window under the ToolbarControl gets painted.

Remarks

The BackColor, FadeColor and FillDirection properties do not affect the visual appearance of the ToolbarControl when Transparent is set to true.

Product Availability

Available with ArcGIS Engine.

Specified by:

isTransparent in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setTransparent

public void setTransparent(boolean _boolean)
                    throws IOException,
                           AutomationException

Indicates if the ToolbarControl has a transparent background.

Product Availability

Available with ArcGIS Engine.

Specified by:

setTransparent in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isShowHiddenItems

public boolean isShowHiddenItems()
                          throws IOException,
                                 AutomationException

Indicates if the ToolbarControl has a hidden items menu containing items currently not visible.

Description

Determines whether any hidden items on the ToolbarControl are visible on a 'hidden items menu' when the button containing two chevrons is clicked by the end user. By default this property is false.

When ShowHiddenItems is false, the last visible item on the ToolbarControl may be partially visible only (and all subsequent items will be inaccessible) depending on the size of the ToolbarControl .

Remarks

The 'hidden items menu' can only be displayed at runtime, when the ToolbarControl is not in Customize mode.

Product Availability

Available with ArcGIS Engine.

Specified by:

isShowHiddenItems in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setShowHiddenItems

public void setShowHiddenItems(boolean _boolean)
                        throws IOException,
                               AutomationException

Indicates if the ToolbarControl has a hidden items menu containing items currently not visible.

Product Availability

Available with ArcGIS Engine.

Specified by:

setShowHiddenItems in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getIconSize

public int getIconSize()
                throws IOException,
                       AutomationException

The size in pixels of icons displayed on the ToolbarControl.

Description

The size in pixels that each item on the ToolbarControl will display the ICommand::Bitmap property. By default bitmaps are stretched to a size of 16 x 16 pixels. The minimum IconSize allowed is 8.

Remarks

IconSize may not affect the size of an item on the ToolbarControl that contains an object implementing IToolControl. Whether the ToolControl responds to the resize depends on its implementation.

Product Availability

Available with ArcGIS Engine.

Specified by:

getIconSize in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setIconSize

public void setIconSize(int size)
                 throws IOException,
                        AutomationException

The size in pixels of icons displayed on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setIconSize in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isAlignLeft

public boolean isAlignLeft()
                    throws IOException,
                           AutomationException

Indicates if the ToolbarControl displays menu and palette items aligned to the left or right.

Description

Determines whether ToolbarMenu and ToolbarPalette items (and any sub menus they contain) on the ToolbarControl popup in a position aligned to the left of the ToolbarControl. This property is true by default.

Remarks

If a ToolbarMenu or ToolbarPalette is to popup in a position so close to edge of a screen display, that it will not be fully visible, the AlignLeft property will be ignored. The ToolbarMenu or ToolbarPalette will popup aligned in a direction that will ensure it is fully visible.

AlignLeft does not affect the alignment of an ICommand::Caption, IToolbarMenu::Caption or IToolbarPalette::Caption displayed on a ToolbarItem. In order to change the direction text is displayed the RTL (right to left) display environment variable need changing. The AlignLeft property will override any RTL (right to left) display environment variables that affect the position of drop downs.

Product Availability

Available with ArcGIS Engine.

Specified by:

isAlignLeft in interface IToolbarControlDefault

Returns:

The returnValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAlignLeft

public void setAlignLeft(boolean _boolean)
                  throws IOException,
                         AutomationException

Indicates if the ToolbarControl displays menu and palette items aligned to the left or right.

Product Availability

Available with ArcGIS Engine.

Specified by:

setAlignLeft in interface IToolbarControlDefault

Parameters:

rhs1 - The rhs1 (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

loadItems

public void loadItems(IStream iStream)
               throws IOException,
                      AutomationException

Loads items into the ToolbarControl from a previously saved stream.

Description

Loads the specified items into the ToolbarControl. Any items on the ToolbarControl before the LoadItems method is used, will be removed and replaced by the contents of the stream.

Use the LoadItems method in conjunction with the IBlobStream::LoadFromFile method to load any previously saved customizations made to the ToolbarControl by a user with the CustomizeDialog. The stream can be saved into a users profile using the SaveItems method, when an application exits, and the items loaded back into the ToolbarControl when the application is restarted using the LoadItems method.

Product Availability

Available with ArcGIS Engine.

Specified by:

loadItems in interface IToolbarControlDefault

Parameters:

pStream - A reference to a com.esri.arcgis.system.IStream (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

saveItems

public void saveItems(IStream iStream)
               throws IOException,
                      AutomationException

Saves the ToolbarControl items into a stream.

Description

Persists the any items on the ToolbarControl out as a MemoryBlobStream.

Use the SaveItems method in conjunction with the IBlobStream::SaveToFile method to save any customizations made to the ToolbarControl by a user with the CustomizeDialog. The stream can be saved into a users profile, when an application exits, and the items loaded back into the ToolbarControl when the application is restarted using the LoadItems method.

Product Availability

Available with ArcGIS Engine.

Specified by:

saveItems in interface IToolbarControlDefault

Parameters:

pStream - A reference to a com.esri.arcgis.system.IStream (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.