ObjectLayout

Returns or changes the layout or model space of an object.

Syntax

Rhino.ObjectLayout (strObject [, strLayout [, blnReturnName]])

Parameters

strObject

Required.  String.  The identifier of the object.

strLayout

Optional.  String.  To change, or move, an object from model space to page layout space, or from one page layout to another, then specify the title or identifier of an existing page layout view. To move an object from page layout space to model space, just specify Null.

blnReturnName

Optional.  Boolean.  If True (default), then the name, or title, of the page layout view is returned. If False, then the identifier of the page layout view is returned.

Returns

String

If strLayout is not specified,  the object's current page layout view if successful. Note, if the object is not in page layout space, Null is returned.

String

If strLayout  is specified, the object's previous page layout view if successful. Note, if the object was not in page layout space, Null is returned.

Null

If not successful, or on error.

Example

Dim strObject

strObject = Rhino.GetObject("Select object")

If Not IsNull(strObject) Then

Rhino.ObjectLayout strObject, "Page 1"

End If

Also See

IsLayoutObject

IsLayout

ViewNames