SearchTriangles Method (TinDataset)

In This Topic

Retrieves the triangles in the TIN that satisfy the criteria set in the . If no filter is set, all triangles that intersect the data extent will be retrieved. This method must be called on the MCT. Use QueuedTask.Run.

Syntax

Visual Basic (Declaration)
C#

Public Function SearchTriangles( _
   ByVal filter As TinTriangleFilter _
) As TinTriangleCursor

public TinTriangleCursor SearchTriangles( 
   TinTriangleFilter filter
)

Parameters

filter: Filter by parameters. See TinTriangleFilter. If null, then all triangles will be retrieved.

Return Value

A TinTriangleCursor.

Exceptions

Exception	Description
ArcGIS.Core.CalledOnWrongThreadException	This method or property must be called within the lambda passed to QueuedTask.Run

Remarks

To ensure maximum robustness, callers should explicitly dispose of the returned TinTriangleCursor in either a using statement or a finally block.

Example

Search for TIN Triangles

{
  // search all triangles that intersect the data extent
  using (ArcGIS.Core.Data.Analyst3D.TinTriangleCursor triangleSearchCursor = tinDataset.SearchTriangles(null))
  {
    while (triangleCursor.MoveNext())
    {
      using (ArcGIS.Core.Data.Analyst3D.TinTriangle triangleCurrent = triangleCursor.Current)
      {

      }
    }
  }

  // search within an extent
  ArcGIS.Core.Data.Analyst3D.TinTriangleFilter triangleFilter = new ArcGIS.Core.Data.Analyst3D.TinTriangleFilter();
  triangleFilter.FilterEnvelope = envelope;
  using (ArcGIS.Core.Data.Analyst3D.TinTriangleCursor triangleSearchCursor = tinDataset.SearchTriangles(triangleFilter))
  {
    while (triangleCursor.MoveNext())
    {
      using (ArcGIS.Core.Data.Analyst3D.TinTriangle triangleCurrent = triangleCursor.Current)
      {

      }
    }
  }

  // search all "inside" triangles
  triangleFilter = new ArcGIS.Core.Data.Analyst3D.TinTriangleFilter();
  triangleFilter.FilterType = ArcGIS.Core.Data.Analyst3D.TinFilterType.InsideDataArea;
  using (ArcGIS.Core.Data.Analyst3D.TinTriangleCursor triangleSearchCursor = tinDataset.SearchTriangles(triangleFilter))
  {
    while (triangleCursor.MoveNext())
    {
      using (ArcGIS.Core.Data.Analyst3D.TinTriangle triangleCurrent = triangleCursor.Current)
      {

      }
    }
  }
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.2 or higher.

Reference

TinDataset Class
TinDataset Members

Send feedback