[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


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

SYNOPSIS
    Response = ClearDMRequest( Window )
    D0                         A0

    BOOL ClearDMRequest( struct 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()