QPx_SetAreaTools

QPx_SetAreaTools(areaRef; areaRef):error
areaRef Longint QPix area reference
areaTools Longint Area tools
error Longint Error result

Configure the tools 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 areaTools specifies the tools of the plug-in area. It is a set of flags that can be constructed by combining with bitwise "OR" any of the mask constants. Alternatively, you can set or clear individual bits of the areaTools parameter using 4D's "Bit set" (?+) and "Bit clear" (?-) bitwise operators. Use the tool constants to address specific tools:

qpx_PointerTool 0 Pointer tool
qpx_MarqueeTool 1 Marquee tool
qpx_ZoomTool 2 Magnifying lens (zoom) tool
qpx_HandTool 3 Free scrolling (hand) tool
qpx_PointerMask 1 Mask for pointer tool
qpx_MarqueeMask 2 Mask for marquee tool
qpx_ZoomMask 4 Mask for zoom tool
qpx_HandMask 8 Mask for hand tool

Example

   // Set the plugin area tools to pointer and marquee tool

C_LONGINT($error)
C_LONGINT($areaTools)

$areaTools:=qpx_PointerMask | qpx_MarqueeMask

$error:=QPx_SetAreaTools (gQPixArea;$areaTools)

Related commands

QPx_GetAreaTools Get the configuration of the tools of a scrollable QPix plug-in area