ITinAdvanced2.GetCountedUniqueTagValues Method

Returns unique tag values with counts for the specified element type.

[Visual Basic .NET]
Public Sub GetCountedUniqueTagValues ( _
    ByVal Type As esriTinElementType, _
    ByRef ppValues As ILongArray, _
    ByRef ppCounts As ILongArray _
)

[C#]
public void GetCountedUniqueTagValues (
    esriTinElementType Type,
    ref ILongArray ppValues,
    ref ILongArray ppCounts
);

[C++]
HRESULT GetCountedUniqueTagValues(
  esriTinElementType Type,
  ILongArray** ppValues,
  ILongArray** ppCounts
);

[C++]
Parameters
Type [in]
  Type is a parameter of type esriTinElementType
ppValues [out]
  ppValues is a parameter of type ILongArray
ppCounts [out]
  ppCounts is a parameter of type ILongArray

Product Availability

Description

Returns an array of integers containing all the tag values used for the given element type - node, edge, or triangle. An additional returned array reports the number of elements that have been assigned a particular tag. The indices of the two arrays correspond with one another. So, the first element of the count array indicates the number of elements that have been assigned the value of the of the first element in the tag value array.

The arrays can potentially be as large as the number of elements. It's a good idea to check how many unique values there are using UniqueTagValueCount before executing this function.

When an edge is assigned a tag the corresponding edge in the adjacent triangle is automatically assigned the same tag. So, even though you only assigned one unique tag to an individual edge the reported element count for that tag will reported as two. The only exception is with super edges where there are no adjacent triangles with corresponding edges.

The returned tag values will be sorted in ascending order if the TIN has been created by, or saved/copied by the 8.1 version of this software or later. The tag values might otherwise not be sorted.

The arrays will be set to Null ('Nothing' in VB) if the TIN has no tags related to the specified element type.

Note as soon as one element is assigned a tag all the other elements of the same type are given the default tag of 0. So, if you only assign a one non-zero tag to one element you will find two values reported by this member, 0 and the value you assigned.

See Also