Contents page

Index

RTGetLong

  NAME RTGetLong()


    ULONG ret = RTGetLong(ULONG var, char *title, struct rtReqInfo *reqinfo);


    ULONG ret = RTGetLong(ULONG var, char *title, struct rtReqInfo *reqinfo,
                          ULONG *taglist);


  DESCRIPTION
    Puts up a requester to get a signed long (32-bit) number from the user.


    'reqinfo' can be used to customize the requester.  For greater control
    use the tags listed below.  The advantage of the rtReqInfo structure is
    that it is global, where tags have to be specified each function call.
    See libraries/reqtools.[hi] for a description of the rtReqInfo structure.


  NOTE
    'var' will NOT change if the requester is aborted.


    See reqtools developer documentation for descriptions of tag items which
    can be used with RTFileRequestA


  INPUTS
    &var - address of long (32 bit!) variable to hold result.
    title    - pointer to null terminated title of requester window.
    reqinfo  - pointer to a rtReqInfo structure allocated with
               rtAllocRequest() or NULL.
    taglist  - pointer to a TagItem array.


  RESULT
    ret - TRUE if user entered a number, FALSE if not. If one of your idcmp
          flags caused the requester to end 'ret' will hold this flag.
          If you used the RTGL_GadFmt tag the return code will hold the
          value of the response as with rtEZRequestA().


  BUGS
    none known


  SEE ALSO
    m_reqinfo