|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Provides access to members that return information about topology errors.
The ITopologyErrorInterface provides access for working with error features in a topology. Topology errors are generated for each instance of a topology rule that is determined to be invalid during the validation process. Topology error features can also be deleted during the validation process. Topology rules are created using the ITopologyRule interface and added to the topology with the ITopologyRuleContainer interface. Topology rules are generally specified as a required topological relationship between collections of features in one or more classes.
Error features cannot be edited directly, so while you can QI for interfaces such as IFeature on a TopoloyErrorFeature, calling methids such as IFeature::Value or IFeature::Store will fail. Topology errors have an associated geometry that can be used to rendering or fixing of the error. Topology errors are persisted with the topology.
The only modifications that can be made to topology error features is by marking them as exceptions. A topology feature that is maked as an exception will return True for its IsException property. A errors can be marked as excetions by passing it as an argument to ITopologyRuleContainer::PromoteToRuleException, and an exception can be marked as an error by passing it as an argument to ITopologyRuleContainer::DemoteFromRuleException.
| Method Summary | |
int |
getDestinationClassID()
ObjectClassID of the destination feature that created the topology error. |
int |
getDestinationOID()
ObjectID of the destination feature that created the topology error. |
int |
getErrorID()
ID of the error. |
int |
getOriginClassID()
ObjectClassID of the origin feature that created the topology error. |
int |
getOriginOID()
ObjectID of the origin feature that created the topology error. |
int |
getShapeType()
The geometry type of the topology error. |
IRule |
getTopologyRule()
The topology rule that caused the topology error. |
int |
getTopologyRuleType()
The Object Class for the row. |
boolean |
isDeleted()
Indicates if this topology error feature has been deleted. |
boolean |
isException()
Indicates if topology error is an exception. |
| Method Detail |
public int getErrorID()
throws java.io.IOException,
AutomationException
The ErrorID of a topology error feature is not unique across all topology error features within the topology, but is unique for each topology error feature geometry type. For example, while a topology error feature with polygon geometry may have the same ErrorID as a topology error feature with point geometry, the ErrorID will be unique for all topology error features with polygon geometry.
Combining the ErrorID and ShapeType of a topology error feature will result in a unique value within the topology.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public boolean isDeleted()
throws java.io.IOException,
AutomationException
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getOriginOID()
throws java.io.IOException,
AutomationException
The OriginOID and DestinationOID properties represent the object IDs of the origin and destination features that created the topology error.
In general, all topology errors for which only the origin class has been specified will return values for the OriginClassID and OriginOID properties and a value of zero for the DestinationClassID and DestinationOID properties. The exception is for topology errors generated from the esriTRTNoGaps rule, which will return a value of zero for the OriginOID as well as DestinationClassID and DestinationOID properties. In addition, topology rules whose origin and destination feature class have been specified will generally return zero for the Destination feature class properties. The exceptions to this rule are:
The exception to both of these statements is the esriTRTAreaAreaCoverEachOther rule, which may generate topology errors referencing either the Origin or Destination feature class.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getOriginClassID()
throws java.io.IOException,
AutomationException
The OriginClassID and DestinationClassID properties represent the object class IDs of the origin and destination feature classes of the topology rule.
In general, all topology errors for which only the origin class has been specified will return values for the OriginClassID and OriginOID properties and a value of zero for the DestinationClassID and DestinationOID properties. The exception is for topology errors generated from the esriTRTNoGaps rule, which will return a value of zero for the OriginOID as well as DestinationClassID and DestinationOID properties. In addition, topology rules whose origin and destination feature class have been specified will generally return zero for the Destination feature class properties. The exceptions to this rule are:
The exception to both of these statements is the esriTRTAreaAreaCoverEachOther rule, which may generate topology errors referencing either the Origin or Destination feature class.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getDestinationOID()
throws java.io.IOException,
AutomationException
The OriginOID and DestinationOID properties represent the object IDs of the origin and destination features that created the topology error.
In general, all topology errors for which only the origin class has been specified will return values for the OriginClassID and OriginOID properties and a value of zero for the DestinationClassID and DestinationOID properties. The exception is for topology errors generated from the esriTRTNoGaps rule, which will return a value of zero for the OriginOID as well as DestinationClassID and DestinationOID properties. In addition, topology rules whose origin and destination feature class have been specified will generally return zero for the Destination feature class properties. The exceptions to this rule are:
The exception to both of these statements is the esriTRTAreaAreaCoverEachOther rule, which may generate topology errors referencing either the Origin or Destination feature class.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getDestinationClassID()
throws java.io.IOException,
AutomationException
The OriginClassID and DestinationClassID properties represent the object class IDs of the origin and destination feature classes of the topology rule.
In general, all topology errors for which only the origin class has been specified will return values for the OriginClassID and OriginOID properties and a value of zero for the DestinationClassID and DestinationOID properties. The exception is for topology errors generated from the esriTRTNoGaps rule, which will return a value of zero for the OriginOID as well as DestinationClassID and DestinationOID properties. In addition, topology rules whose origin and destination feature class have been specified will generally return zero for the Destination feature class properties. The exceptions to this rule are:
The exception to both of these statements is the esriTRTAreaAreaCoverEachOther rule, which may generate topology errors referencing either the Origin or Destination feature class.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public boolean isException()
throws java.io.IOException,
AutomationException
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public IRule getTopologyRule()
throws java.io.IOException,
AutomationException
The TopologyRule property returns an IRule object corresponding to the topology rule. This can be used to get the unique ID of the topology rule using IRule::ID or obtain a ITopologyRule object. TopologyRule provides access the properties of the topology rule that the Error feature has violated. Note that each Topology has one inherent rule, esriTRTFeatureLargerThanClusterTolerance. It can be identified by checking the ITopologyErrorFeature::TopologyRuleType property
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getTopologyRuleType()
throws java.io.IOException,
AutomationException
The TopologyRuleType property returns the type of topology rule associated with the topology error feature from the esriTopologyRuleType constants. Each topology has one inherent rule, esriTRTFeatureLargerThanClusterTolerance, which identified features that are less than the defined cluster tolerance for the topology.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getShapeType()
throws java.io.IOException,
AutomationException
The ShapeType property will return the esriGeometryType of the topology error feature. Topology error features will be one of three possible geometry types: esriGeometryPolygon , esriGeometryPolyline or esriGeometryPolyline. Several topology rules can produce topology error features of different shape types, use the ITopologyRule::ErrorShapeTypes method to determine the valid shape types for each rule.
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||