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 |