int error = ListRequest(APTR handle, STRPTR title, STRPTR body, STRPTR choices, ULONG flags, int *result, struct hwTagList *tags);
NULLcharacters. The end of this list is marked by two
Your implementation has to write the index of the list item chosen by the user
result parameter which is a pointer to an
int. List items are counted
from 0 which marks the first item. If the user has cancelled the requester, your
ListRequest() implementation has to write -1 to the
Hollywood also passes a taglist to this function. Your implementation has to handle the following tags:
iDatamember of this tag item is set to
Trueif Hollywood has called you while the script is running. This might be important to know because requesters should not block window refresh so you might want to setup a temporary modal event loop if this tag has been set to
Trueto enable your display to stay responsive.
iDatamember. Item indices are counted from 0 so if
iDatais 0, you'd have to preselect the first list item.
Note that Hollywood won't call FreeRequest() for this
requester type because
ListRequest() shouldn't have to allocate any resources.
ListRequest() is an optional API and must only be implemented if
HWSRAFLAGS_LISTREQUEST has been
passed to hw_SetRequesterAdapter(). See hw_SetRequesterAdapter for details.
NULLif no display is open
intpointer for storing the user's selection