com.esri.arcgis.editor
Interface INotifyZFinalize

All Superinterfaces:

Serializable

All Known Implementing Classes:

INotifyZFinalizeProxy

public interface INotifyZFinalize
extends Serializable

Provides access to a callback method the Editor will call if Z Attribution of a geometry fails.

Description

This interface is new at ArcGIS 9.3.

Product Availability

Available with ArcGIS Desktop.

Method Summary

boolean

failed(IGeometry geometry) Callback is called when Z Capture fails, allows client an opportunity to set a custom Z.

Method Detail

failed

boolean failed(IGeometry geometry)
               throws IOException,
                      AutomationException

Callback is called when Z Capture fails, allows client an opportunity to set a custom Z.

Remarks

When a point is added to the sketch, if the result is non-simple then the Failed method of the class implementing INotifyZFinalize and hooked into IEditProperties4::NotifyZFinalize is given an opportunity to manipulate the Z values. If the client implementing this interface alters the geometry, they should return TRUE; if the value returned is FALSE then any changes made to the geometry in this method will be discarded.

Product Availability

Available with ArcGIS Desktop.

Parameters:

geometry - A reference to a com.esri.arcgis.geometry.IGeometry (in)

Returns:

The handled

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.