int error = StringRequest(APTR handle, STRPTR title, STRPTR body, ULONG flags, STRPTR *result, struct hwTagList *tags);
tags parameters are used to control further parameters of the
string requester. The following flags are currently defined:
Please note that all the
HWSTRINGREQTYPE_XXX flags are mutually
exclusive. Only one from this group will be set.
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 of this tag.
StringRequest() is an optional API and must only be implemented if
HWSRAFLAGS_STRINGREQUEST has been
passed to hw_SetRequesterAdapter(). See hw_SetRequesterAdapter for details.
NULLif no display is open
STRPTRpointer for storing the user's selection