ArcObjects Library Reference (Editor)

INotifyZFinalize Interface

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

Product Availability

Available with ArcGIS Desktop.

Description

This interface is new at ArcGIS 9.3.

Members

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

[C#]

bool INotifyZFinalize.Failed(IGeometry Geometry)
{
  // When your Failed method is called, you have the opportunity to address the
  // failure case on the input geometry. If you choose to handle it you should
  // return TRUE to notify the editor that the client (your extension) 
  // handled it. Otherwise the editor will use its fallback logic (usually
  // apply current Z) prior to storage
  
  bool bHandled = false;
  if (Geometry.GeometryType == esriGeometryType.esriGeometryPoint)
  {
    IZAware zAware = (IZAware)Geometry;
    zAware.ZAware = true;
    ((IPoint)Geometry).Z = 5;
     bHandled =   true;
  
  }  
  else
  {
    IZ z = (IZ)Geometry;
    z.CalculateNonSimpleZs();
    bHandled = true;    
  }  
  
  return bHandled;
}

[Visual Basic .NET]

Private Function Failed(ByVal Geometry As IGeometry) As Boolean Implements INotifyZFinalize.Failed
' When your Failed method is called, you have the opportunity to address the
' failure case on the input geometry. If you choose to handle it you should
' return TRUE to notify the editor that the client (your extension)
' handled it. Otherwise the editor will use its fallback logic (usually
' apply current Z) prior to storage bool bHandled = false;
If Geometry.GeometryType = esriGeometryType.esriGeometryPoint Then
   Dim zAware As IZAware = CType(Geometry, IZAware)
   zAware.ZAware = True
   CType(Geometry, IPoint).Z = 5
   bHandled = True
Else
    Dim z As IZ = CType(Geometry, IZ)
    z.CalculateNonSimpleZs()
    bHandled = True
End If

Return bHandled
End Function