ITinEdit2.ResetExtent Method

Reset TIN's extent.

[Visual Basic .NET]
Public Sub ResetExtent ( _
    ByVal pExtent As IEnvelope _
)

[C#]
public void ResetExtent (
    IEnvelope pExtent
);

[C++]
HRESULT ResetExtent(
  IEnvelope* pExtent
);

[C++]
Parameters
pExtent [in]
  pExtent is a parameter of type IEnvelope

Product Availability

Description

Redefines the declared 2D data area for the TIN using the rectangle defined by pExtent. This is the area into which data added to the TIN should fall.

This method can only be called if the TIN has four super nodes and no other data. An error is returned if that condition is not met.

The typical use case for this method pertains to the editing of TINs created by the Create TIN geoprocessing tool. That tool can create and save 'empty' TINs, where no data was added to the triangulation. When the tool does that the delcared data extent for the TIN is set to the domain of the TIN's spatial reference. It uses that because it doesn't know the data extent since no data was added. That domain is huge. If left unchanged, it can result in both performance and precision issues when data is added. For cases like this ResetExtent should be called right before adding data when the proper extent is known so the TIN's four super nodes can be repositioned before triangulation occurs.

See Also