Docs » Autodocs » intuition.library » ClearDMRequest
ClearDMRequest -- Clear (detaches) the DMRequest of the window.
Response = ClearDMRequest( Window ) D0 A0 BOOL ClearDMRequest( struct Window * );
Attempts to clear the DMRequest from the specified window, that is detaches the special requester that you attach to the double-click of the menu button which the user can then bring up on demand. This routine WILL NOT clear the DMRequest if it's active (in use by the user). The IDCMP message class IDCMP_REQCLEAR can be used to detect that the requester is not in use, but that message is sent only when the last of perhaps several requesters in use in a window is terminated.
Window = pointer to the window from which the DMRequest is to be cleared.
If the DMRequest was not currently in use, detaches the DMRequest from the window and returns TRUE. If the DMRequest was currently in use, doesn't change anything and returns FALSE.
SetDMRequest(), Request()
|