Classes Class XbpPresSpace() :configure()

Method XbpPresSpace():configure() Foundation

Reconfigures an existing presentation space.

Syntax 
:configure( [<oDevice>], [<aPageSize>], [<nUnits>] ) --> self
Parameters
<oDevice>
The optional parameter <oDevice> can be used to specify a device context such as an XbpPrinter() or XbpMetaFile() object, or the return value of the :winDevice() method of Xbase Parts can be used. This is used to link an existing presentation space with a new device context. If <oDevice> is not specified, the presentation space is not linked to any device context.
<aPageSize>
This parameter has the same meaning as it does for the :create()method (see the :create() method for more information). If it is not specified, the previously set page size is retained.
<nUnits>
This parameter has the same meaning as it does for the :create()method (see the :create() method for more information). If it is not specified, the previously set coordinate system units are retained.
Return

This method returns the object executing the method (self).

Description

The :configure() method reconfigures an existing presentation space. It can be used to link a different device context, modify the page size and/or change the coordinate system units. When a presentation space is no longer needed but additional output is to occur in another device context, it is better from a memory management standpoint to reconfigure an existing presentation space than to create a new one.

When a new device context is specified or when the page size is modified most of the data contained in an XbpPresSpace object are reset to their default values, and previous changes are lost.

If only <oDevice> is passed all attributes for graphic primitives are reset to their default values, open graphical paths and segments are discarded, a clipping path is disabled, a transformation matrix is reset to initial state, and the pen position is set to the point {0,0}.

In addition, when <aPageSize> or <nUnits> is specified all existing graphical segments are deleted, the viewport is reset and the drawing mode is set to default (see the :drawMode() method).

Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.