[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()