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


    NAME
        BuildEasyRequestArgs -- Simple creation of system request. (V36)
        BuildEasyRequest -- Varargs stub for BuildEasyRequestArgs(). (V36)

    SYNOPSIS
        ReqWindow = BuildEasyRequestArgs( RefWindow, easyStruct, IDCMP, Args )
        D0                                A0         A1          D0     A3

        struct window *buildeasyrequestargs( struct window *,
                struct easystruct *, ulong, aptr );

        ReqWindow = BuildEasyRequest( RefWindow, easyStruct, IDCMP, Arg1, ... )

        struct window *buildeasyrequest( struct window *,
                struct easystruct *, ulong, aptr, ... );

    FUNCTION
        This function is to EasyRequest() as buildsysrequest() is to
        AutoRequest(): it returns a pointer to the system requester
        window.  The input from that window can then be processed
        under application control.

        It is recommended that this processing be done with
        sysreqhandler(), so that future enhancement to the
        processing will be enjoyed.

        After you have determined that the requester is satisfied or
        cancelled, you must free this requester using freesysrequest().

        Please see the autodoc for EasyRequest().

        NOTE: This function switches the processor stack to ensure
        sufficient stack space for the function to complete.

    INPUTS
        window = reference window for requester: determines the
            requester window title and screen.
        easyStruct = pointer to easystruct structure, as described
            in the EasyRequest() autodocs.
        IDCMP = (NOT A POINTER) provided application specific IDCMP
            flags for the system requester window.
        Args = see easyrequestargs()

    RESULT
        A pointer to the system request window opened.  In the event
        of problems, you may also be returned the value '0' which
        is to be interpreted as the "FALSE, Cancel" choice, or
        (if you have a second gadget defined) the value '1', which
        is to be taken to mean the equivalent of your corresponding
        left-most gadget.

        If there is a problem creating the window, a recoverable alert may
        be substituted for the requester, and the result, either 0 or 1,
        returned.

    BUGS
        Does not put up alternative alert.
        See also BUGS listed for easyrequestargs().

    SEE ALSO
        easyrequestargs(), freesysrequest(), sysreqhandler(),
        buildsysrequest(), autorequest()