RFModel.FindFeaturesByName

Description

Searches and collects features named as specified in an RFEntityID array and returns a Long value indicating the number of searched features.

Syntax

Function RFModel.FindFeaturesByName(Name As String, firstOnly As Boolean, maxFeatureCount As Long, pFeatureIDs As RFEntityID) As Long

The FindFeaturesByName syntax has these parts:

Part	Description
Name	[IN] String Required. String expression containing feature name to search.
firstOnly	[IN] Boolean Required. It determines if the searching stops when the first feature is found which is named as specified.
maxFeatureCount	[IN] Long Required. The size of pFeatureIDs array. (Maximum number of found feature expected.)
pFeatureIDs	[OUT] RFEntityID Required. The first element of RFEntityID array to store features RFEntityID.

Remarks

Memory storage space of pFeatureIDs array needs to be allocated prior to calling this method by the size of maxFeatureCount.

Note

Name of an entity is not a unique identifier. So that there can be multiple features that have the same name.