com.esri.arcgis.controls
Class IToolbarItemProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.controls.IToolbarItemProxy

All Implemented Interfaces:

IToolbarItem, Externalizable, Serializable

Direct Known Subclasses:

IToolbarItem2Proxy

public class IToolbarItemProxy
extends com.esri.arcgis.interop.Dispatch
implements IToolbarItem, Serializable

Provides access to members that control ToolbarControl items.

Superseded By

IToolbarItem2

Description

A ToolbarItem represents a Command, Tool, ToolControl, Menu or Palette item on the ToolbarControl. These items generally appear as buttons however, a ToolControl will provide its own window, and will typically be a combo box.

Product Availability

Available with ArcGIS Engine.

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IToolbarItemProxy()
	IToolbarItemProxy(Object obj)
protected	IToolbarItemProxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
ICommand	getCommand() The command used by the item.
Object	getCustomProperty() A property to associate data with an item.
int	getGroupSpacing() The width of the group separator in pixels if present.
IToolbarMenu	getMenu() If the item is a menu, this property is a ToolbarMenu object.
int	getStyle() The style of the item.
IUID	getUID() The UID of the command used by the item, which may be empty.
boolean	isGroup() Indicates if a group separator exists to the left of the item on the ToolbarControl.
void	removeListener(String iidStr, Object theListener)
void	setCustomProperty(Object pVal) A property to associate data with an item.
void	setGroup(boolean pVal) Indicates if a group separator exists to the left of the item on the ToolbarControl.
void	setGroupSpacing(int pVal) The width of the group separator in pixels if present.
void	setStyle(int pVal) The style of the item.

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IToolbarItemProxy

public IToolbarItemProxy()

IToolbarItemProxy

public IToolbarItemProxy(Object obj)
                  throws IOException

Throws:

IOException

IToolbarItemProxy

protected IToolbarItemProxy(Object obj,
                            String iid)
                     throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class com.esri.arcgis.interop.Dispatch

Throws:

IOException

getCommand

public ICommand getCommand()
                    throws IOException,
                           AutomationException

The command used by the item.

Description

Returns the ICommand object used by the Command, Tool or ToolControl item. If the item is using a Menu, an IMultiItem object or Palette Nothing is returned.

Product Availability

Available with ArcGIS Engine.

Specified by:

getCommand in interface IToolbarItem

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getUID

public IUID getUID()
            throws IOException,
                   AutomationException

The UID of the command used by the item, which may be empty.

Description

Returns the UID of the Command used by the item. The method will return Nothing if the command has been added to the CommandPool using either the AddCommand or IToolbarControl::AddItem methods without a UID or ProgID supplied.

The UID objects are managed in association with objects implementing ICommand by the IToolbarControl::CommandPool.

Product Availability

Available with ArcGIS Engine.

Specified by:

getUID in interface IToolbarItem

Returns:

A reference to a com.esri.arcgis.system.IUID

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isGroup

public boolean isGroup()
                throws IOException,
                       AutomationException

Indicates if a group separator exists to the left of the item on the ToolbarControl.

Description

Determines whether a separator exists to the left of the item on the ToolbarControl. The separator will appear as verticle line. By default Group is False.

Product Availability

Available with ArcGIS Engine.

Specified by:

isGroup in interface IToolbarItem

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setGroup

public void setGroup(boolean pVal)
              throws IOException,
                     AutomationException

Indicates if a group separator exists to the left of the item on the ToolbarControl.

Product Availability

Available with ArcGIS Engine.

Specified by:

setGroup in interface IToolbarItem

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getGroupSpacing

public int getGroupSpacing()
                    throws IOException,
                           AutomationException

The width of the group separator in pixels if present.

Description

Determines the width in pixels of a Group separator if it exists to the left the of the item on the ToolbarControl. The separator appears as verticle line and is drawn to the left of the GroupSpacing. A zero value sets the GroupSpacing to its default value (currently 4 pixels).

Product Availability

Available with ArcGIS Engine.

Specified by:

getGroupSpacing in interface IToolbarItem

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setGroupSpacing

public void setGroupSpacing(int pVal)
                     throws IOException,
                            AutomationException

The width of the group separator in pixels if present.

Product Availability

Available with ArcGIS Engine.

Specified by:

setGroupSpacing in interface IToolbarItem

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getStyle

public int getStyle()
             throws IOException,
                    AutomationException

The style of the item. Displays a combination of text caption and bitmap.

Description

Determines the Style of the item on the ToolbarControl, and whether the Caption, or Bitmap or Caption and Bitmap defined within the Command are displayed on the ToolbarControl. By default the Style is esriCommandStyleIconOnly. If the item has a Menu then the Style is fixed to a esriCommandStyleMenuBar Style.

Product Availability

Available with ArcGIS Engine.

Specified by:

getStyle in interface IToolbarItem

Returns:

A com.esri.arcgis.systemUI.esriCommandStyles constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setStyle

public void setStyle(int pVal)
              throws IOException,
                     AutomationException

The style of the item. Displays a combination of text caption and bitmap.

Product Availability

Available with ArcGIS Engine.

Specified by:

setStyle in interface IToolbarItem

Parameters:

pVal - A com.esri.arcgis.systemUI.esriCommandStyles constant (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 an item.

Description

Use the CustomProperty to associate any useful data with the ToolbarItem. 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 IToolbarItem

Returns:

A Variant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCustomProperty

public void setCustomProperty(Object pVal)
                       throws IOException,
                              AutomationException

A property to associate data with an item.

Product Availability

Available with ArcGIS Engine.

Specified by:

setCustomProperty in interface IToolbarItem

Parameters:

pVal - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMenu

public IToolbarMenu getMenu()
                     throws IOException,
                            AutomationException

If the item is a menu, this property is a ToolbarMenu object.

Description

Returns the IToolbarMenu used by the item if the item represents a menu. If the item does not use a menu Nothing is returned.

Product Availability

Available with ArcGIS Engine.

Specified by:

getMenu in interface IToolbarItem

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.