IFeatureGroups80

A feature group is a group of features within a layer which share the same geometry and display style. A feature layer can have multiple feature groups each containing a homogeneous collection of point, polyline, or polygon objects.

This interface provides access to a layer’s feature groups and gets and sets their properties.

 

	Properties
	Annotation	An IFeatureGroup80 representing the annotation properties of the feature group.
	Count	Gets the number of feature groups in the layer.
	Item	Gets the IFeatureGroup80 element in the specified zero-based index.
	Point	An IFeatureGroup80 representing a feature group with a point geometry type.
	Polygon	An IFeatureGroup80 representing a feature group with a polygon geometry type.
	Polyline	An IFeatureGroup80 representing a feature group with a polyline geometry type.
	Text	An IFeatureGroup80 representing the annotation text of the feature group.
	Methods
	SetClassification	Sets a classification XML for a specified property for all groups.
	SetProperty	Sets the value of a specified property.

Count

Gets the number of feature groups in the layer.

 

JavaScript
Count

 

C#
int Count { get; }

 

C++
HRESULT Count([out, retval] long* pVal)

Item

Gets the IFeatureGroup80 element in the specified zero-based index.

To access a specific element use the following syntax: IFeatureGroups80(index).

C# exposes this property as an indexer accessed using the following syntax: IFeatureGroups80[index].

 

JavaScript
Item(        Index)

 

C#
dynamic this[object Index] { get; }

 

C++
HRESULT Item(        [in] VARIANT Index,        [out, retval] VARIANT* pVal)

SetClassification

This method sets a classification XML for a specified property for all groups. Classification XML is used for persistence of a classification which is defined in the TerraExplorer Pro GUI. When a classification is defined using the Field by Attribute dialog box, you can use GetClassification to retrieve an XML that defines this classification. See “Feature Layers” chapter in the User Manual. Use SetProperty to set a value (e.g., set “Text” to “Bus Station”) for a specified property instead.

 

JavaScript
SetClassification(        Name,        Value)

 

C#
void SetClassification(        string Name,        string Value)

 

C++
HRESULT SetClassification(        BSTR Name,        BSTR Value)

Parameters

Name

The name of the property to be set. The parameter can be a name of any property field as it appears in the Layer tab of the Layer property sheet in TerraExplorer (e.g., “Altitude Method”).

Value

The value of the property. This parameter can be a classification XML.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.

SetProperty

This method sets the value of a specified property for all groups. Unlike the SetClassification method, SetProperty cannot set classification values. See: SetClassification for further details.

 

JavaScript
SetProperty(        Name,        Value)

 

C#
void SetProperty(        string Name,        object Value)

 

C++
HRESULT SetProperty(        BSTR Name,        VARIANT Value)

 

Parameters

Name

The name of the property to set. The parameter can be any property field name as it appears in the Layer property sheet in TerraExplorer (e.g., “Line Color”).

Note:    This parameter must be in English even when the user interface is in a different language.

Value

The value to assign to the property. Pass the variable type that is expected for the specified property, e.g. for “Line Color” pass a long type value.

If the property is a drop-down menu, pass the zero-based integer index of the order in the list. For example, for “Activation Action” pass 0 for “Fly To” and 1 for “Circle Pattern”. See below for an additional example:

See IFeatureGroup80.SetProperty for a list of exceptions to this rule.

Exceptions

See: HRESULT Return Values for a list of possible values returned by the HRESULT.