### QPx_GetAreaTools

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

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

Example

``Add zoom tool to the plugin area tools` `` `C_LONGINT($error)` `C_LONGINT($areaTools)` `` `$error:=QPx_GetAreaTools (gQPixArea;$areaTools)` `` `If ($error=qpx_noErr)` `` `$areaTools:=$areaTools ?+ qpx_ZoomTool` `` `$error:=QPx_SetAreaTools (gQPixArea;$areaTools)` `` `End if` ``

Related commands

QPx_SetAreaTools | Configures the tools popup menu of a scrollable QPix plug-in area

QPix © Escape
Generated by QDoc 2.8 on Wed, Feb 17, 2010 17:43:54