ObjectPrintWidth

Returns or modifies the print width of an object.  Object print widths are measured in millimeters (mm).

Syntax

Rhino.ObjectPrintWidth (strObject [, dblWidth])

Rhino.ObjectPrintWidth (arrObjects, dblWidth)

Parameters

strObject

Required.  String.  The identifier of the object.

arrObjects

Required.  Array.  An array of strings identifying the objects to modify.

dblWidth

Optional.  Number.  The new print width value in millimeters, where dblWidth = 0.0 means use the default width, and dblWidth < 0.0 means do not print (visible for screen display, but does not show on print).  If omitted, the current object print width is returned.  Note, if arrObjects is specified, dblWidth is required.

Returns

Number

If a print width value is not specified,  the current print width value if successful.

Number

If a print width value is specified, the previous print width value if successful.

Number

If arrObjects is specified, then the number of objects modified if successful.

Null

If not successful, or on error.

Example

Dim arrObjects, strObject

arrObjects = Rhino.GetObjects("Select objects to change print width")

If IsArray(arrObjects) Then

  For Each strObject In arrObjects

    Rhino.ObjectPrintWidth strObject, 0.5

  Next

End If

Also See

ObjectPrintWidthSource