com.esri.arcgis.schematic
Class INgPropertyProxy

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

All Implemented Interfaces:

INgProperty, Externalizable, Serializable

public class INgPropertyProxy
extends com.esri.arcgis.interop.Dispatch
implements INgProperty, Serializable

Provides access to members that control the property.

Description

Properties are used to define the characteristics of a group of elements that have an impact in the graphic representation of a network. The overall state of a network is determined by the values taken by the existing set of properties at a given time. A property is associated with a single element group.

A label displayed either directly on the elements it applies to or inside a flag associated with these elements can represent any property. The position of the text is determined either relative to the objects (above/below, for links) or by a port number (for nodes or flags).

A property created for the sole purpose of displaying a label on an element or inside the flag attached to this element is said to be textual. To associate graphic effects with a property, the possible values of the property must first be specified. If these values belong to a finite set of numbers or alphanumeric codes, the property is said to be discrete. If the values are simply numeric and indifferent (that is, they belong to a range of values), the property is said to be bounded. To assign specific graphic effects to that property, a filter must be defined for each of its possible values. Along with the textual, discrete, and bounded properties, a fourth property, the direct property, is also available for directly applying a given graphic effect, depending on the values taken up by the property itself—that is, scale factor and symbology.

In all cases, the values used to define any property effect are returned through an attribute that must be associated with the property. Each attribute may be related to one or several fields stored in the database.

The use of properties depends on whether its related element type is associated with a group. A property is always related to a element type. It can be created or associated with this element type.

Product Availability

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

See Also:

INgDiscreteProperty, INgTextualProperty, INgBoundedProperty, INgElementType.createProperty(String, int, int, int), Serialized Form

Field Summary

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

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E

Constructor Summary

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

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	delete() Deletes the property.
INgAttribute	getAssociatedAttribute() Attribute the property is associated with.
INgFlagModel	getDisplayFlagModel() Flag model used by the property.
Object	getEffect(int effect) Returns the effect 'effect' set for the property (see esriNgPropertyEffect).
INgElementType	getElementType() Element type the property is related to.
String	getName() Name of the property.
int	getType() Type of the property (see esriNgPropertyType).
boolean	isEffectSet(int effect) Indicates if the effect 'effect' related to the property is set (see esriNgPropertyEffect).
void	readExternal(ObjectInput in)
void	removeEffect(int effect) Removes the effect or restores the default effect 'effect' set for the property (see esriNgPropertyEffect).
void	removeListener(String iidStr, Object theListener)
void	setDisplayFlagModel(INgFlagModel pVal) Flag model used by the property.
void	setEffect(int effect, Object effValue) Modifies the effect 'effect' set for the property (see esriNgPropertyEffect).
void	setName(String pVal) Name of the property.
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

INgPropertyProxy

public INgPropertyProxy()

INgPropertyProxy

public INgPropertyProxy(Object obj)
                 throws IOException

Throws:

IOException

INgPropertyProxy

protected INgPropertyProxy(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

getName

public String getName()
               throws IOException,
                      AutomationException

Name of the property.

Description

This name has been defined when the property was created

- Either by calling the INgElementType CreateProperty method in the program code

- Or when the property has been created with ArcGIS Schematics Designer

Product Availability

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

Specified by:

getName in interface INgProperty

Returns:

The pVal

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setName

public void setName(String pVal)
             throws IOException,
                    AutomationException

Name of the property.

Product Availability

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

Specified by:

setName in interface INgProperty

Parameters:

pVal - The pVal (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getType

public int getType()
            throws IOException,
                   AutomationException

Type of the property (see esriNgPropertyType).

Product Availability

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

Specified by:

getType in interface INgProperty

Returns:

A com.esri.arcgis.schematic.esriNgPropertyType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getEffect

public Object getEffect(int effect)
                 throws IOException,
                        AutomationException

Returns the effect 'effect' set for the property (see esriNgPropertyEffect).

Product Availability

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

Specified by:

getEffect in interface INgProperty

Parameters:

effect - A com.esri.arcgis.schematic.esriNgPropertyEffect constant (in)

Returns:

A Variant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgProperty.isEffectSet(int), INgProperty.removeEffect(int), INgProperty.setEffect(int, java.lang.Object)

setEffect

public void setEffect(int effect,
                      Object effValue)
               throws IOException,
                      AutomationException

Modifies the effect 'effect' set for the property (see esriNgPropertyEffect).

Product Availability

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

Specified by:

setEffect in interface INgProperty

Parameters:

effect - A com.esri.arcgis.schematic.esriNgPropertyEffect constant (in)

effValue - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgProperty.isEffectSet(int), INgProperty.removeEffect(int), INgProperty.getEffect(int)

removeEffect

public void removeEffect(int effect)
                  throws IOException,
                         AutomationException

Removes the effect or restores the default effect 'effect' set for the property (see esriNgPropertyEffect).

Description

Note that when removing an effect that is always set, the ;property default effect value is automatically restored; and removing an effect that is not set by default, really removes the property effect.

Product Availability

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

Specified by:

removeEffect in interface INgProperty

Parameters:

effect - A com.esri.arcgis.schematic.esriNgPropertyEffect constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgProperty.isEffectSet(int), INgProperty.setEffect(int, java.lang.Object), INgProperty.getEffect(int)

isEffectSet

public boolean isEffectSet(int effect)
                    throws IOException,
                           AutomationException

Indicates if the effect 'effect' related to the property is set (see esriNgPropertyEffect).

Description

By default, Schematics automatically sets default values for some property effects (see the List of the property effect default values, below). For all these effects, the IsEffectSet method returns True. For the other effects (those that are not automatically set by default), the IsEffectSet method returns True only if the effect has been set:

- Either when defining the property's characteristics in ArcGIS Schematics Designer

- Or by calling the SetEffect method in the project code.

List of the property effect default values

esriNgPropertyDecimalPrecision: -1

esriNgPropertyLabelDisplayMode: esriNgDisplayPropertyValue

esriNgPropertyLabelPlacement: esriNgAbove

esriNgPropertyLabelPort: 0

esriNgPropertyLegendNotes: nothing. But, by default, Schematics displays the property name

esriNgPropertyLegendVisibility: esriNgVisible

esriNgPropertyStatus: esriNgEnabled

esriNgPropertyStringLenght: -1

esriNgPropertyValueType: esriNgFloatPropertyValue, esriNgIntegerPropertyValue or esriNgStringPropertyValue. This parameter is fixed when the property is created.

For more details, see Property Effects Definition.

Product Availability

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

Specified by:

isEffectSet in interface INgProperty

Parameters:

effect - A com.esri.arcgis.schematic.esriNgPropertyEffect constant (in)

Returns:

The isSet

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgProperty.removeEffect(int), INgProperty.setEffect(int, java.lang.Object), INgProperty.getEffect(int)

getElementType

public INgElementType getElementType()
                              throws IOException,
                                     AutomationException

Element type the property is related to.

Product Availability

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

Specified by:

getElementType in interface INgProperty

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgElementType.getProperties(), INgElementType.createProperty(String, int, int, int)

getDisplayFlagModel

public INgFlagModel getDisplayFlagModel()
                                 throws IOException,
                                        AutomationException

Flag model used by the property.

Product Availability

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

Specified by:

getDisplayFlagModel in interface INgProperty

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDisplayFlagModel

public void setDisplayFlagModel(INgFlagModel pVal)
                         throws IOException,
                                AutomationException

Flag model used by the property.

Product Availability

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

Specified by:

setDisplayFlagModel in interface INgProperty

Parameters:

pVal - A reference to a com.esri.arcgis.schematic.INgFlagModel (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 property.

Product Availability

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

Specified by:

delete in interface INgProperty

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgElementType.createProperty(String, int, int, int)

getAssociatedAttribute

public INgAttribute getAssociatedAttribute()
                                    throws IOException,
                                           AutomationException

Attribute the property is associated with.

Product Availability

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

Specified by:

getAssociatedAttribute in interface INgProperty

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

See Also:

INgElementType.getAssociatedPropertyAttribute(String)

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