MatchObjectAttributes

Matches, or copies, the attributes of a source object to a target object or an array of target objects. If the source object is not specified, the attributes of the target object(s) will be reset to Rhino's default object attributes.

Syntax

Rhino.MatchObjectAttributes (strTarget [, strSource])

Rhino.MatchObjectAttributes (arrTargets [,strSource])

Parameters

strTarget

Required.  String.  The identifier of the target object.

arrTargets

Required.  Array.   An array of strings identifying the target objects.

strSource

Optional.  String.  The identifier of the source object.  If the source object is not specified, the attributes of the target object(s) will be reset to Rhino's default object attributes.

Returns

Number

The number of objects whose attributes were modified if successful.

Null

If not successful, or on error.

Example

Dim arrTargets, strSource

arrTargets = Rhino.GetObjects("Select objects")

If IsArray(arrTargets) Then

  strSource = Rhino.GetObject("Select object to match")

  If Not IsNull(strSource) Then

    Rhino.MatchObjectAttributes arrTargets, strSource

  End If

End If

Also See

GetObject

GetObjects