XPRINT SET OVERLAP statement

Purpose | Enables or disables XPRINT Overlap Mode.
Syntax | XPRINT SET OVERLAP [NumrExpr&]

Remarks

XPRINT SET OVERLAP enables or disables overlap mode for the host printer which is currently attached to the XPRINT stream. It has no effect on any other XPRINT target. If NumrExpr& is true (non-zero), overlap mode is enabled. If false (zero), overlap mode is disabled. If NumrExpr& is missing, the default is to enable Overlap Mode.

With Overlap Mode, you can control how PowerBASIC treats XPRINT operations which involve a bounding rectangle (RECT structure) in their definition. Windows maintains unique conventions for a RECT. The bottom and right coordinates of a RECT are exclusive. In other words, the pixels at the bottom and right edges lie immediately outside the rectangle. They are ignored. For example:

XPRINT BOX (0,0) - (50,50)

In this case, a box is drawn from 0,0 to 49,49. The final pixels at the bottom and right edge are simply not drawn. However, if Overlap Mode is enabled, the box is drawn from 0,0 to 50,50.

The Overlap Mode affects all XPRINT functions which take a bounding rectangle as a parameter. This includes XPRINT SCALE, XPRINT BOX, XPRINT ELLIPSE, XPRINT LINE, XPRINT POLYLINE, etc.

See also | XPRINT BOX, XPRINT ELLIPSE, XPRINT GET OVERLAP, XPRINT LINE, XPRINT POLYLINE, XPRINT SCALE