audio_form object
This method will clear a listbox, deleting all items.
bool clear_list(int control_id)
Parameters:
control_id
The control ID of the listbox.
Return value:
true on success, false on failure.
Remarks:
None.
Example:

    // Make a simple form with a few buttons and a listbox.

    #include "form.bgt"

    audio_form form;

    void main()
    {
    form.create_window("Example Form", true);
    int list=form.create_list("&People", 0);
    form.add_list_item(list, "Joseph", -1);
    form.add_list_item(list, "Samuel", -1);
    form.add_list_item(list, "Percival", 1);
    form.add_list_item(list, "William", -1);
    form.add_list_item(list, "Edward", 0);
    form.clear_list(list);
    int ok=form.create_button("OK");
    int cancel=form.create_button("E&xit");
    while(true)
    {
    form.monitor();
    wait(5);
    if(form.is_pressed(ok))
    {
    exit();
    }
    if(form.is_pressed(cancel))
    {
    exit();
    }
    if((key_down(KEY_LMENU))&&(key_pressed(KEY_F4)))
    {
    exit();
    }
    }
    }