RFModel.FindShellsByName

Description

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

Syntax

Function RFModel.FindShellsByName(Name As String, firstOnly As Boolean, maxShellCount As Long, pShellIDs As RFEntityID) As Long

The FindShellsByName syntax has these parts:

Part	Description
Name	[IN] String Required. String expression containing shell name to be searched.
firstOnly	[IN] Boolean Required. It determines if the searching stops when the first shell is found which is named as specified.
maxShellCount	[IN] Long Required. The size of pShellIDs array. (Maximum number of found shells expected.)
pShellIDs	[OUT] RFEntityID Required. The first element of RFEntityID array to store shells RFEntityID.

Remarks

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

Note

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