### QPx_SetAreaZoomFactor

QPx_SetAreaZoomFactor(areaRef; zoomFactor):error
| areaRef | Longint | QPix area reference
| zoomFactor | Real | Zoom factor
| error | Longint | Error result

Changes the zoom factor of a scrollable QPix plug-in area.

The QPix plug-in area is specified by areaRef. If areaRef is not a valid QPix plug-in area reference, qpx_paramErr is returned.

Parameter zoomFactor specifies the zoom factor. It must be in the range of 1/16 to 16. Passing 1 as the zoom factor displays the area content in normal size (100%).

In addition to the normal zoom values, zoomFactor can be set to one of the following constants. These will cause auto-zooming to fit the image within the plug-in area as described below:

qpx_ZoomToFitHorz | -1 | Adjust zooming so that the image fits within the plug-in area horizontally. The result zooming will not be greater than 100% (normal size).
qpx_ZoomToFitVert | -2 | Adjust zooming so that the image fits within the plug-in area vertically. The result zooming will not be greater than 100% (normal size).
qpx_ZoomToFit | -3 | Adjust zooming so that the image fits within the plug-in area both horizontally and vertically. The result zooming will not be greater than 100% (normal size).
qpx_ZoomToFill | -4 | Adjust zooming so that the image fills the plug-in area horizontally and vertically. The result zooming will not be greater than 100% (normal size).

To allow auto-zooming above 100%, add qpx_ZoomCanStretch.

qpx_ZoomCanStretch | -8 | When added to the other zooming constants, allows zooming to be greater than 100%.

Related commands

QPx_GetAreaZoomFactor | Returns the zoom factor of a scrollable QPix plug-in area

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:44:06