There's no sensation to compare with this. | ||
--Pink Floyd, Learning To Fly |
In this section, we'll introduce and discuss all ReqTools
tags being part of the tagging system.
These tags are shared between all ReqTools
requesters. These are generic tags
that you can use to set (for example) requester's title or text or window position.
This tag is used to pass to define the buttons that the user will be able to press. The value passed to this tag is a string containing all the valid buttons labels.
Each button label is separated from the next one using the "|" (pipe) char.
Cancel button: The last button label is always associated with the Cancel button.
These tags are used to pass the default R,G,B values for the color requester.
Valid values range from 0 to 65535 inclusive. This big range for R,G,B and Alpha values
has been designed to give you the most accurate setting for the color you want. Anyway,
if you are more familiar with the 0 to 255 values, you can wrap your values with these
provided macro: RT_SMALL_COL
and RT_BIG_COL
,
which convert small numbers (0-255) to big and vice versa.
This tag should be only used by new ReqTools
requesters implementators.
This tag defines the default button of a requester. The tag gets an ordinal value as input that should correspond to the ordinal button.
This tag defines the window that is generating the ReqTools
requester.
If you provide this value, then the ReqTools
requester
will appear in the center of the parent window.
Parent Window is a GTK+ window: The parent window passed is actually a GTK+ window
This tag defines the text of the ReqTools
requester. Text can be spawned on
multiple lines using the standard "\n" newline char.
This tag defines the alignement. Valid values are:
Align the text on the left
Align the text on the right
Align the text on the center
Fully align text on both left and right margins
This tag is used to define if you want or not a border around the text of the requester. Valid values are TRUE or FALSE.
This tag is used to define the ReqTools
requester winodw title.
This tag defines the ReqTools
requester window width and height.
Measures are given in pixels.
At the moment the Easy Requester does not have any special tag.
With this tag you can enable or disable the way ReqTools Input
will handle
keys from the user. Valid modes are:
Will accept all alphabetic chars (from a to z) but no numbers or punctiation.
Will accept all numeric chars (from 0 to 9) but no alphabetic chars or punctiation.
Will accept all chars that are not alphabetic nor numeric.
Will accept only chars defined with the tag REQTOOLS_INPUT_VALID_CHARS. See below for more info.
This tag sets the default text that will appear in the ReqTools Input
.
This tag sets the maximum length of the text input field.
These tags are used to define the minimum and maximum values that an user can insert inside a numeric field.
This tag defines the valid chars a user can insert inside a text field. It is very useful to filter the input from a user.
These tags are used to define function callbacks when the user clicks or double clicks on a list row.
Function prototype for the callback is:
void function_name ( void * )
This tag defines the number of columns that the ReqTools
List Requester
will have.
This tag defines the way selection will work inside the ReqTools List Requester
.
Valid values are:
Equals to GTK_SELECTION_SINGLE
Equals to GTK_SELECTION_BROWSE
Equals to GTK_SELECTION_MULTIPLE
Equals to GTK_SELECTION_EXTENDED
If the value passed to this tag is TRUE, then the fore color used to display entries on the list will be the one defined by reqtools_list_set_color(), and not the default one.
If the value passed to this tag is TRUE, then the background color used to display entries on the list will be the one defined by reqtools_list_set_color(), and not the default one.
This tag defines the starting file name for the ReqTools File Requester
.
This tag defines the starting path for the ReqTools File Requester
.
If this tag is set to TRUE, then files and directories will be shown using different colors similar to those used in the original Amiga ReqTools library.
At the moment the Color Requester does not have any special tag.