QPx_GetAreaParts

QPx_GetAreaParts(areaRef; areaParts):error
areaRef Longint QPix area reference
areaParts Longint Area parts
error Longint Error result

Returns the configuration of the visual parts 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 areaParts receives a value that describes the visual parts of the plug-in area. The received value is a set of flags that can be tested for specific parts by bitwise "and" of any of the mask constants. Alternatively, you can test individual bits of the areaParts parameter using 4D's "Bit test" (??) bitwise operator. Use the part constants to address specific parts:

qpx_MenubarPart 1 Area menubar part
qpx_ToolsWidgetPart 2 Tools widget part
qpx_ZoomWidgetPart 3 Zoom widget part
qpx_MenubarMask 2 Mask for area menubar part
qpx_ToolsWidgetMask 4 Mask for tools widget part
qpx_ZoomWidgetMask 8 Mask for zoom widget part
qpx_PageNavWidgetPart 4 Page navigation widget part
qpx_PageNavWidgetPartMask 16 Mask for page navigation widget part

Example

  `Toggle the visibility of the menubar
 
C_LONGINT($error)
C_LONGINT($areaParts)
 
$error:=QPx_GetAreaParts (gQPixArea;$areaParts)
 
If ($error=qpx_noErr)
 
  If ($areaParts ?? qpx_MenubarPart)
    $areaParts:=$areaParts ?- qpx_MenubarPart
  Else
    $areaParts:=$areaParts ?+ qpx_MenubarPart
  End if
 
  $error:=QPx_SetAreaParts (gQPixArea;$areaParts)
 
End if
 

Related commands

QPx_SetAreaParts Configures the visual parts of a scrollable QPix plug-in area

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