NAME
Request -- Activate a requester.
SYNOPSIS
Success = Request( requester, window )
D0 A0 A1
bool request( struct requester *, struct window * );
FUNCTION
Links in and displays a requester into the specified window.
This routine ignores the window's IDCMP_REQVERIFY flag.
INPUTS
requester = pointer to the requester to be displayed
window = pointer to the window into which this requester goes
New for V36: the POINTREL flag now has meaning if the requester
is not a DMR (Double-Menu Requester):
If POINTREL is set this requester should be placed in the center
of the window, offset by Requester.RelLeft and Requester.RelTop.
If the requester doesn't fit in the window, its position will be
adjusted to show the upper-left corner.
RESULT
If the requester is successfully opened, TRUE is returned. Otherwise,
if the requester could not be opened, FALSE is returned.
BUGS
It turns out that the return code of this function is not
always correct under V34 and prior. If your requester does
not have an ENDGADGET, then you can examine window->FirstRequest
to see if your requester successfully opened. (A requester with
an ENDGADGET can go away all by itself before you get the chance
to look). Under V36 and higher, the return code from this routine
is fine.
There is a maximum of 8 requesters that are supported in
a window that can be changed in size, position, or depth.
SEE ALSO
The Requesters section of the Intuition Reference Manual