Download Amiga Intuition Reference Manual

ClearDMRequest
ClearDMRequest
NAME
ClearDMRequest — Clears the DMRequest of the window.
SYNOPSIS
ClearDMRequest(Window);
A0
FUNCTION
Attempts to clear the DMRequester from the specified window. The DMRequester is
the special requester that you attach to the double-click of the menu button; the user
can then bring up that requester on demand. This routine will not clear the
DMRequester if it is active (in use by the user). If you want to change the
DMRequester after having called SetDMRequest(), the correct way to start is by
calling ClearDMRequest() until it returns a value of TRUE; then you can call
SetDMRequest() with the new DMRequester.
INPUTS
Window = pointer to the structure of a window from which the DMRequest is to be
cleared.
RESULT
If the DMRequest was not currently in use, this function zeroes out the DMRequest
pointer in the window and returns TRUE.
If the DMRequest was currently in use, this function does not change the pointer and
returns FALSE.
BUGS
None.
SEE ALSO
SetDMRequest().
Request().
A-15