VgaGames4

VgaGames4 - canvas man-pages

[.. upper level ..]

# 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.