## ConstructionHistory.Filter

### Description

Returns a collection of Operator objects that match the specified criteria.

### C# Syntax

    OperatorCollection ConstructionHistory.Filter( String in_filter, Object in_famArray, String in_path );

### Scripting Syntax

    oReturn = ConstructionHistory.Filter( [Type], [Family], [Path] );

### Return Value

OperatorCollection

### Parameters

Parameter | Type | Description
--- | --- | ---
Type | String | Operator type e.g. twistop (see Operator Information for a list of available operators.)
Family | siFamily | Name of family to filter by (for example, use "siDeformOperatorFamily" for the deform operator family).
Path | String | Name of object(s) as an Object List string expression (for example, "twist*" to return all twist operators).

### Examples

#### VBScript Example

    ' The following code illustrates how to get a ConstructionHistory,

    ' filter the construction history for DeformOperators and then iterate

    ' the converters using the For Each...Next statement:

    Dim oGPig

    ' See if there are any DeformOperators now

    Set oGPig = ActiveSceneRoot.AddGeometry( "Torus", "MeshSurface" )

    ShowTransforms oGPig

    ' Apply a Bend Operator and then see

    ApplyOp "bend", oGPig

    ShowTransforms oGPig

    ' Apply a Twist Operator and then see

    ApplyOp "twist", oGPig

    ShowTransforms oGPig

    Function ShowTransforms( in_object )

    	Dim oStack, oTransform, sMemberList

    	Set oStack = in_object.ActivePrimitive.ConstructionHistory.Filter( , siDeformOperatorFamily )

    	If oStack.Count > 0 Then

    		For Each oTransform In oStack

    			sMemberList = sMemberList & oTransform.Name & ", "

    		Next

    		sMemberList = Left( sMemberList, ( Len( sMemberList ) - 2 ) )

    	Else

    		sMemberList = "(none found)"

    	End If

    	LogMessage sMemberList

    	ShowConstructionHistory = sMemberList

    End Function

    ' Output of above script:

    'INFO : "(none found)"

    'INFO : "Bend Op"

    'INFO : "Twist Op, Bend Op"