VgaGames4

VgaGames4 - canvas man-pages

[.. upper level ..]

# vg4->canvas->list_add()

Add list-item to selection-list.

SYNTAX
VG_BOOL vg4->canvas->list_add(struct VG_Canvas *cvas, const char *iname, const char *text, const char *ename)
FUNCTION PARAMETERS

cvas | Canvas
iname | Name of selection-list
text | Text of list-item
ename | Name of list-item

RETURN VALUE
Returns boolean: - VG_TRUE: added - VG_FALSE: not added
DESCRIPTION
Add list-item to selection-list. See section CV-LIST in vg4->canvas->load().
EXAMPLE

      struct VG_Canvas *cvas;

      /* load canvas containing an empty selection-list named "list1" */
      [...]

      /* add three list-items */
      vg4->canvas->list_add(cvas, "list1", "First line in list", "key1");
      vg4->canvas->list_add(cvas, "list1", "Second line in list", "key2");
      vg4->canvas->list_add(cvas, "list1", "Third line in list", "key3");

SEE ALSO
vg4->canvas->list_clear() vg4->canvas->list_set_activated() vg4->canvas->list_get_activated()