Home  /  Autodocs

requester.class

create requester BOOPSI objects

FUNCTIONS

RM_OPENREQ REQUESTER_GetClass

SUPERCLASS

rootclass

DESCRIPTION

The requester class is used to show information and query requesters, get integer and and to get string information in an easy and consistent way.

Advantages that this class provides:

ATTRIBUTES

REQ_Type (ULONG)
Type of requester. See <classes/requester.h> for definitions.

Defaults to REQTYPE_INFO.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQ_TitleText (UBYTE *)
Title text of the requester.

Defaults to none.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQ_BodyText (UBYTE *)
Body text of the requester. The following codes can be used to change the appearence of the text:

ESC u - Set the soft style to underline.

ESC b - Set the soft style to bold.

ESC i - Set the soft style to italic.

ESC n - Set the soft style back to normal.

ESC l - Left justify the following text.

ESC c - Center the following text.

ESC r - Right justify the following text.

ESC <n> - Use pen number n (1-9) as front pen. n must be a valid

DrawInfo pen as specified in <intuition/screens.h>. Note that this is the _offset_ into the drinfo->dri_Pens array, and not a absolute pen number.

ESC f[<font>/<size>] - Use the given font with the given size

on the text that follows.

Example text:

"\33b\33f[topaz.font/8]This is bold text with Topaz/8."

Defaults to none.

NOTE:
Do not use the "\33<pen>" representation when selecting pen to use since the compiler will translate this to the wrong octal number. Instead, use the ESC key on the keyboard, like "<ESC><pen>".

NOTE:
Due to limitations in label.image, the justification codes can only be used once in the text. If you use it more than once, the last one will be used for all of the text. This might change in future versions of label.image.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQ_VarArgs (APTR)

Varargs data array to supply data for RawDoFmt() when format specifiers are to be used in REQ_BodyText text string.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ). (V47).

REQ_GadgetText (UBYTE *)
Gadget text(s) for the requester.

Defaults to "_Ok|_Cancel".

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQ_ReturnCode (ULONG)
Last return code of the requester.

Applicability is (OM_GET).

REQ_TabSize (ULONG)
*** NOT IMPLEMENTED YET *** Tab size to use when formatting the bodytext.

Defaults to 8.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQ_Image (struct Image *)
Use this tag to specify the image being displayed in the requester You can either supply your own BOOPSI image or you can use one of

the build-in images:

REQIMAGE_DEFAULT
Based on the gadget/option count REQIMAGE_INFO (one gadget/option) or REQIMAGE_QUESTION (>1) is used.

REQIMAGE_INFO
a '!' sign.

REQIMAGE_QUESTION
a '?' sign.

REQIMAGE_WARNING
a warning sign.

REQIMAGE_ERROR
an error sign.

REQIMAGE_INSERTDISK
an insert disk sign.

Defaults to REQIMAGE_DEFAULT.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ). (V47).

REQI_Minimum (LONG)
Minimum allowed value.

Defaults to MININT.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQI_Maximum (LONG)
Maximum allowed value.

Defaults to MAXINT.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQI_Invisible (BOOL)
Integer input will be echoed with '.' and not what the user actually types. V50.

Defaults to FALSE.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQI_Number (LONG)
Number to show in gadget.

Defaults to 0.

Applicability is (OM_NEW, OM_SET, OM_GET, RM_OPENREQ).

REQI_Arrows (BOOL)
Show arrows to the right of the integer gadget.

Defaults to FALSE.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQI_MaxChars (UWORD)
Maximum number of characters for the number (including negative sign).

Defaults to 10 and 10 is also the highest value allowed.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_AllowEmpty (BOOL)
Allow empty string to be accepted.

Defaults to FALSE.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_Invisible (BOOL)
String input will be echoed with '.' and not what the user actually types. V50.

Defaults to FALSE.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_Buffer (UBYTE *)
Buffer used in the string gadget. MUST be provided.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_ShowDefault (BOOL)
Show content of REQS_Buffer in string gadget.

Defaults to TRUE.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_MaxChars (ULONG)
Maximum number of characters in string gadget. Must not be larger than size of REQS_Buffer - 1.

Defaults to 127.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ).

REQS_ChooserArray (UBYTE **)
(V42) An array of strings that will be added to a chooser gadget to the right of the string gadget.

Applicability is (OM_NEW, OM_SET, RM_OPENREQ)

REQS_ChooserActive (ULONG)
(V42) The current active entry among the strings passed in using REQS_ChooserOptions. (default: 0)

Applicability is (OM_NEW, OM_SET, OM_GET, RM_OPENREQ)