QPx_SetAreaStyle

QPx_SetAreaStyle(areaRef; areaRef; areaRef; areaRef):error
areaRef Longint QPix area reference
displayFormat Longint Display format
frameStyle Longint Frame style
focusRing Longint Focus ring style
error Longint Error result

Configure the appearance of a 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 displayFormat specifies how the plug-in area displays its content. Set displayFormat to qpx_PictScrolling to configure the area as scrollable, or use any other constant to emulate 4D's picture display formats:

qpx_PictScrolling 0 Picture has scrollbars
qpx_PictTruncCentered 1 Picture is truncated to the area rectangle size and centered in it
qpx_PictScaledToFit 2 Picture is scaled up or down separately across each dimension to fit the current area rectangle
qpx_PictTruncNonCenter 4 Picture is truncated to the area rectangle size and placed top left
qpx_PictScaledToFitProp 5 Picture is scaled down proportionally to fit the current area rectangle and placed top left
qpx_PictScaledToFitPropCenter 6 Picture is scaled down proportionally to fit the current area rectangle and centered

Parameter frameStyle does nothing. The area's frame is no longer set using this parameter; use 4D's form editor to control the area object's frame.

Parameter focusRing specifies the style of the area focus ring. Use one of the following constants:

qpx_NoFocus 0 No focus indication
qpx_SystemFocus 1 Focus indication using the system hilite color

Example

   // Set the plugin area to scrollable, no focus

C_LONGINT($error)
C_LONGINT($displayFormat;$focusStyle)

$displayFormat:=qpx_PictScrolling
$focusStyle:=qpx_NoFocus

$error:=QPx_SetAreaStyle (gQPixArea;$displayFormat;0;$focusStyle)

Related commands

QPx_GetAreaStyle Get the appearance configuration of a QPix plug-in area