[Overview][Constants][Types][Procedures and functions][Variables][Index] Reference for unit 'Intuition' (#aros)


Easy alternative to AutoRequest()


Source position: intuition.pas line 3285

function EasyRequestArgs(

  Window: PWindow;

  EasyStruct: PEasyStruct;

  IDCMP_Ptr: PLongWord;

  Args: APTR





Reference window pointer, determines the screen and title of the requester window. This can be nil, which means the requester is to appear on the Workbench screen, or default public screen, if defined.



A Pointer to EasyStruct structure



A pointer to IDCMP flags that you want to terminate the requester. This pointer may be nil.



Arguments for format commands. Arguments for GadFmt follow arguments for TextFmt.

Function result

0, 1, ..., N = Successive GadgetID values, for the gadgets you specify for the requester. Note: The numbering from left to right is actually: 1, 2, ..., N, 0. This is for compatibility with AutoRequest(), which has False for the rightmost gadget.

-1 = Means that one of the caller-supplied IDCMPFlags occurred. The IDCMPFlag value is in the LongWord pointed to by IDCMP_ptr.


This function provides a simpler method of using a 'System Requester' than provided by AutoRequest(). It performs layout and size calculations sensitive to the current font and screen resolution.

It provides for the descriptive body text and the gadget text to be constructed from printf style format strings.

It also provides a general way for the requester to be sensitive to particular IDCMP messages.

The first function listed is the actual Intuition library function. It is passed the arguments for the formatting operations as a pointer to the first argument.

Note: The formatting is done by RawDoFmt(), so be aware that to display a 32-bit integer argument, for example, you must say "%ld", not "%d", since RawDoFmt() is "word-oriented."

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

See also



VarArgs Version of EasyRequestArgs()



Format data into a character stream.



Simple creation of system request.



Handle system requester input.



Automatically build and get response from a requester.



Build and display a system requester.

Documentation generated on: 2017-01-10