QPx_GetAreaTools
| 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 |
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 | Configure the tools of a scrollable QPix plug-in area |