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()