Skip to content

Latest commit

 

History

History
44 lines (29 loc) · 1.1 KB

ClearDMRequest.md

File metadata and controls

44 lines (29 loc) · 1.1 KB
Raw

NAME

ClearDMRequest -- Clear (detaches) the DMRequest of the window.

SYNOPSIS

    Response = ClearDMRequest( Window )
    D0                         A0

    BOOL ClearDMRequest( struct Window * );

Links: Window Window

FUNCTION

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.

INPUTS

Window = pointer to the window from which the DMRequest is to be cleared.

RESULT 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.

BUGS

SEE ALSO

SetDMRequest, Request