int error = ColorRequest(APTR handle, STRPTR title, ULONG flags, int *result, struct hwTagList *tags);
intpointer that has been passed as parameter 4. If the user has cancelled the requester,
ColorRequest()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 of this tag item in the color requester.
Note that Hollywood won't call FreeRequest() for this
requester type because
ColorRequest() shouldn't have to allocate any resources.
ColorRequest() is an optional API and must only be implemented if
HWSRAFLAGS_COLORREQUEST has been
passed to hw_SetRequesterAdapter(). See hw_SetRequesterAdapter for details.
NULLif no display is open
intpointer for storing the user's selection