Unit 'Intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#aros]

EasyRequestArgs

Easy alternative to AutoRequest()

Declaration

Source position: intuition.pas line 3285

function EasyRequestArgs(

  Window: PWindow;

  EasyStruct: PEasyStruct;

  IDCMP_Ptr: PLongWord;

  Args: Pointer

):LongInt;

Arguments

Window

  

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.

EasyStruct

  

A Pointer to EasyStruct structure

IDCMP_Ptr

  

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

Args

  

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.

Description

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

EasyRequest

  

VarArgs Version of EasyRequestArgs()

RawDoFmt

  

Format data into a character stream.

BuildEasyRequestArgs

  

Simple creation of system request.

SysReqHandler

  

Handle system requester input.

AutoRequest

  

Automatically build and get response from a requester.

BuildSysRequest

  

Build and display a system requester.


Documentation generated on: 2021-07-30