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

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

Returns the configuration of the tools popup menu 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 receives a value that describes the tools of the plug-in area. The received value is a set of flags that can be tested for specific tools by bitwise "AND" of any of the mask constants. Alternatively, you can test individual bits of the areaTools parameter using 4D's "Bit test" (??) bitwise operator. 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


   // Add zoom tool to the plugin area tools


$error:=QPx_GetAreaTools (gQPixArea;$areaTools)

If ($error=qpx_noErr)
   $areaTools:=$areaTools ?+ qpx_ZoomTool
   $error:=QPx_SetAreaTools (gQPixArea;$areaTools)
End if 

Related commands

QPx_SetAreaTools Configure the tools of a scrollable QPix plug-in area