Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

BuildEasyRequestArgs

Simple creation of system request.

Declaration

Source position: intuition.pas line 3902

function BuildEasyRequestArgs(

  Window: PWindow;

  const EasyStruct: PEasyStruct;

  IDCMP: LongWord;

  const Args: Pointer

):PWindow;

Arguments

Window

  

Reference window for requester: determines the requester window title and screen.

EasyStruct

  

A pointer to EasyStruct structure, as described in the EasyRequestArgs() .

IDCMP

  

(not a pointer) provided application specific IDCMP flags for the system requester window.

Args

  

see EasyRequestArgs()

Function 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.

Description

This function is to EasyRequestArgs() 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 EasyRequestArgs().

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

See also

EasyRequestArgs

  

Easy alternative to AutoRequest()

FreeSysRequest

  

Free resources gotten by a call to BuildSysRequest().

SysReqHandler

  

Handle system requester input.

BuildSysRequest

  

Build and display a system requester.

AutoRequest

  

Automatically build and get response from a requester.


Documentation generated on: 2021-07-30