com.esri.arcgis.schematic
Class INgBehaviorProxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.schematic.INgBehaviorProxy

All Implemented Interfaces:

INgBehavior, Externalizable, Serializable

public class INgBehaviorProxy
extends com.esri.arcgis.interop.Dispatch
implements INgBehavior, Serializable

Provides access to members that control the behavior.

Description

A behavior brings together four elements:

- An event name; that is, an action by the end user: EventName

-Anobject type name: ObjectTypeName

-A metatype of objects: MetaType

A command; that is, the response from the application: Command

which reads: such event (LeftClick, RightClick ...) on such object type of such metatype will trigger such command.

Product Availability

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

See Also:

Serialized Form

Field Summary

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

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E

Constructor Summary

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	delete() Deletes the behavior.
INgCommand	getCommand() Command to be triggered.
String	getEventName() Name of the event to be responded to.
int	getMetaType() Object metatype to be impacted.
String	getObjectTypeName() Identifier for the object type used to filter command triggering.
INgProject	getProject() Project of the behavior.
void	readExternal(ObjectInput in)
void	removeListener(String iidStr, Object theListener)
void	set(String evtName, int metaType, String objectTypeName) Modifies the behavior so that it responds to the event named 'eventName' when such event impacts the object type named 'objectTypeName' whose metatype is 'metaType'.
void	setCommand(INgCommand pVal) Command to be triggered.
void	setEventName(String pVal) Name of the event to be responded to.
void	setMetaType(int pVal) Object metatype to be impacted.
void	setObjectTypeName(String pVal) Identifier for the object type used to filter command triggering.
void	writeExternal(ObjectOutput out)

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, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke

Methods inherited from class java.lang.Object

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

Constructor Detail

INgBehaviorProxy

public INgBehaviorProxy()

INgBehaviorProxy

public INgBehaviorProxy(Object obj)
                 throws IOException

Throws:

IOException

INgBehaviorProxy

protected INgBehaviorProxy(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 INgCommand getCommand()
                      throws IOException,
                             AutomationException

Command to be triggered.

Description

This command must be defined for the currently opened project. Schematics offers a full set of predefined commands, each with its own area of action, which means that it will apply to a given metatype only (for more details about commands, see the INgCommand interface).

Product Availability

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

Specified by:

getCommand in interface INgBehavior

Returns:

A reference to a com.esri.arcgis.schematic.INgCommand

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setCommand

public void setCommand(INgCommand pVal)
                throws IOException,
                       AutomationException

Command to be triggered.

Product Availability

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

Specified by:

setCommand in interface INgBehavior

Parameters:

pVal - A reference to a com.esri.arcgis.schematic.INgCommand (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getEventName

public String getEventName()
                    throws IOException,
                           AutomationException

Name of the event to be responded to.

Description

This event name can be a user event name set by the application or a predefined Schematics event name (generally a mouse click or a keyboard key being pressed). Possible predefined event names depend on the object MetaType.

List of predefined events available from schematic elements

Predefined events available for schematic elements are those available for MetaType metatype "esriNgMetaTypeElement", "esriNgMetaTypeLegendGroup", "esriNgMetaTypeLegendProperty" or "esriNgMetaTypeLegendPropertyFilter"

The predefined event names list is:

• LeftClick: Event triggered by clicking an element with the left mouse button.
• RightClick: Event triggered by clicking an element with the right mouse button.
• LeftDblClick: Event triggered by double clicking an element with the left mouse button
• RightDblClick: Event triggered by double clicking an element with the right mouse button.
• KeykeyFlag/keyCode/keyAscii: Event triggered when pressing either the keyCode, the keyAscii or the keyFlag key (code, ascii code and control code key, respectively). For the event to have an impact, one or several element(s) must be selected. See keyboard key codes list.

List of predefined events available from schematic views

Predefined events available for schematic views are those available for the MetaType metatype "esriNgMetaTypeView"

The predefined event names list is:

• LeftClick: Event triggered by a left mouse button click in a view.
• RightClick: Event triggered by a right mouse button click in a view.
• LeftDblClick: Event triggered by a double left mouse button click in a view.
• RightDblClick: Event triggered by a double right mouse button click in a view.
• KeykeyFlag/keyCode/keyAscii: Event triggered when pressing either the keyCode, the keyAscii or the keyFlag key (code, ascii code and control code key, respectively). For the event to have an impact, a view must be active. See keyboard key codes list.

Note: For all object metatypes (esriNgMetaTypeDiagram, esriNgMetaTypeView, esriNgMetaTypeElement, esriNgMetaTypeLegendGroup, esriNgMetaTypeLegendProperty, esriNgMetaTypeLegendPropertyFilter), you can also use a "UserEventName". This event name is set by the application. It can be triggered by the application through a series of messages exchanged with ArcGIS Schematics.

Product Availability

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

Specified by:

getEventName in interface INgBehavior

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEventName

public void setEventName(String pVal)
                  throws IOException,
                         AutomationException

Name of the event to be responded to.

Product Availability

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

Specified by:

setEventName in interface INgBehavior

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getMetaType

public int getMetaType()
                throws IOException,
                       AutomationException

Object metatype to be impacted.

Description

Here are the list of the MetaType values that are available

• The esriNgMetaTypeDiagram metaType encompasses all of the application’s diagrams, whatever their type.
• The esriNgMetaTypeView metatype encompasses all of the views created by the application (a diagram includes one or several views).
• The esriNgMetaTypeElement metatype encompasses all of the elements defined in the application whatever their graphic type (esriNgElementNode, esriNgElementLink, esriNgElementDrawing, etc.).
• The esriNgMetaTypeLegendGroup encompasses legend entries associated with element groups.
• The esriNgMetaTypeLegendProperty encompasses legend entries associated with properties.
• The esriNgMetaTypeLegendPropertyFilter encompasses legend entries associated with property filters

Product Availability

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

Specified by:

getMetaType in interface INgBehavior

Returns:

A com.esri.arcgis.schematic.esriNgMetaType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setMetaType

public void setMetaType(int pVal)
                 throws IOException,
                        AutomationException

Object metatype to be impacted.

Product Availability

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

Specified by:

setMetaType in interface INgBehavior

Parameters:

pVal - A com.esri.arcgis.schematic.esriNgMetaType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getObjectTypeName

public String getObjectTypeName()
                         throws IOException,
                                AutomationException

Identifier for the object type used to filter command triggering.

Description

The object type name must be defined for the currently open project. If the command is to apply to all object types of the MetaType metatype, this identifier is not required. If the metatype is equal to esriNgMetaTypeView, the ObjectTypeName parameter is set to the name of the diagram type associated with the views. This diagram type must be defined for the currently open project.

Product Availability

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

Specified by:

getObjectTypeName in interface INgBehavior

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setObjectTypeName

public void setObjectTypeName(String pVal)
                       throws IOException,
                              AutomationException

Identifier for the object type used to filter command triggering.

Product Availability

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

Specified by:

setObjectTypeName in interface INgBehavior

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

set

public void set(String evtName,
                int metaType,
                String objectTypeName)
         throws IOException,
                AutomationException

Modifies the behavior so that it responds to the event named 'eventName' when such event impacts the object type named 'objectTypeName' whose metatype is 'metaType'.

Product Availability

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

Specified by:

set in interface INgBehavior

Parameters:

evtName - The evtName (in)

metaType - A com.esri.arcgis.schematic.esriNgMetaType constant (in)

objectTypeName - The objectTypeName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

delete

public void delete()
            throws IOException,
                   AutomationException

Deletes the behavior.

Remarks

Before deleting a behavior, check that its event name is not used by another behavior. For example, behaviors that display popup menus often trigger other behaviors.

Product Availability

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

Specified by:

delete in interface INgBehavior

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getProject

public INgProject getProject()
                      throws IOException,
                             AutomationException

Project of the behavior.

Product Availability

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

Specified by:

getProject in interface INgBehavior

Returns:

A reference to a com.esri.arcgis.schematic.INgProject

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Overrides:

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

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Overrides:

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

Throws:

IOException

ClassNotFoundException