vg4->canvas->exec()
Execute canvas.
SYNTAX
VG_BOOL
vg4->canvas->exec(struct VG_Canvas *cvas,
const struct VG_Position *posdst,
const char **selname)
FUNCTION PARAMETERS
| cvas | Canvas |
| posdst | Canvas-position on window, or NULL = centered |
| selname | For returning name of selected canvas-item: - NULL: cancelled - <empty>: nothing selected, but OK (e.g. by pressing the Return-key) - <not empty>: name of selected canvas-item |
RETURN VALUE
Returns boolean:
- VG_TRUE: OK
- VG_FALSE: Got exit-request
DESCRIPTION
Execute canvas.
A canvas may be executed more times because a selection needs not end showing the canvas.
Selecting a canvas-item may cause the underlying function executing some code
and then execute the canvas again, until a OK-button is clicked.
Clicking on a button or a switch exits from executing
as well as hitting the keyboard return-key on most canvas-items.
To cancel the executing the escape-key must be pressed or a cancel-button clicked.