int error = PathRequest(APTR handle, STRPTR title, ULONG flags, STRPTR *result, struct hwTagList *tags);
NULL
to the result
string pointer.
The flags
and tags
parameters are used to control the appearance of the path requester. The following
flags are currently defined:
HWPATHREQFLAGS_SAVEMODE:
Hollywood also passes a taglist to this function. Your implementation has to handle the following tags:
HWPATHREQTAG_FROMSCRIPT:
iData
member of this tag item is set to True
if 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 True
to enable your display to stay
responsive.
HWPATHREQTAG_DEFDRAWER:
pData
member 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.
NULL
if no display is openSTRPTR
pointer for storing the user's selection