int error = PathRequest(APTR handle, STRPTR title, ULONG flags, STRPTR *result, struct hwTagList *tags);
tags parameters are used to control the appearance of the path requester. The following
flags are currently defined:
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.
pDatamember of this tag item.
PathRequest() is an optional API and must only be implemented if
HWSRAFLAGS_PATHREQUEST has been
passed to hw_SetRequesterAdapter(). See hw_SetRequesterAdapter for details.
NULLif no display is open
STRPTRpointer for storing the user's selection