QPix Command Reference
Image area
|
|
| QPx_SetAreaStyle(areaRef; displayFormat; frameStyle; focusRing):error | |||
|
|
areaRef | Longint | QPix area reference |
|
|
displayFormat | Longint | Display format |
|
|
frameStyle | Longint | Frame style |
|
|
focusRing | Longint | Focus ring style |
|
|
error | Longint | Error result |
Configures the visual 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 specifies the area frame style. Use one of the following constants:
| qpx_PlainFrame | 0 | Puts a black one-pixel frame around the area |
| qpx_SunkenFrame | 1 | Puts a sunken-style frame around the area |
| qpx_NoneFrame | 3 | No frame |
Parameter focusRing specifies the style of the area focus ring. Use one of the following constants:
| qpx_NoFocus | 0 | No focus indication |
| qpx_SmokedFocus | 1 | Cool, smoke-style focus indication |
| qpx_SystemFocus | 2 | Focus indication using the system hilite color |
| qpx_PlainFocus | 3 | Focus indication using a plain frame |
Example
`Set the plugin area to scrollable, shunken, no focus C_LONGINT($error)C_LONGINT($displayFormat;$frameStyle;$focusStyle) $displayFormat:=qpx_PictScrolling$frameStyle:=qpx_SunkenFrame$focusStyle:=qpx_NoFocus $error:=QPx_SetAreaStyle (gQPixArea;$displayFormat;$frameStyle;$focusStyle) |
Related commands
| QPx_GetAreaStyle | Returns the visual appearance configuration of a QPix plug-in area |