@@24 Button definition

Use this function to redefine the fields associated with a button. Possible button types are:
  • Push button
  • Radio button
  • Check box

The type of button is defined by control attributes.

Syntax

syntax-buttondefinition

Field ID

The field ID is the direct address to data. The field ID consists of a starting control character followed by a reference number and ends with the ending control character ampersand (&) or a new starting control character.
Note: All control characters are replaced by a space when you display the panel on-screen or print it out.

Field text

For the most part, the field text definition is used for the following @@ functions to establish a connection between the function and the field: @@24 Button definition, @@27 Listbox definition and @@29 Static control definition.

Use the starting control characters together with the field text.
Note: If the field text in the @@ function and the related field does not correspond, the field is an entry field.

Field number

The field number defines the position of the field in the panel. You can find the field number by counting from the left to the right and from top to bottom.

You can use the field number to connect a @@ function with a field.
Note: If the field number in the @@ function and the related field do not correspond, the field is as entry field.
Use the starting control characters together with the field number.
Caution: 
Every time a new field is inserted or removed, you must recheck field positions. Therefore, you must use the field reference number or field text functions instead.

Group number

The group number is only important for radio buttons. It determines how the click and unclick of the radio buttons are performed. Radio buttons that are grouped together must have a unique group number greater than zero. To move the cursor focus within a group, use the arrow keys on your keyboard. The [TAB] key can be made to jump between groups.
Note: If the group number = 0, then the control will be in its own group. If the group number < 0 the control will has not been created.

Color code

Color includes both the foreground and the background color. The color code is calculated by the using this formula:

Color code = 100 X FOREGROUND COLOR CODE + BACKGROUND COLOR CODE
Note: The default color can not be changed when using the @@29 - @@32 functions.

Example

The number (7) represents a pale gray background with black text.

The number (0313) represents a dark cyan background with yellow text.

Color code table

Code Color Code Color
00 Black 10 Dark red
01 Red 11 Dark pink
02 Dark green 12 Green
03 Yellow 13 Dark cyan
04 Blue 14 Brown
05 Pink 15 White
06 Cyan 16 Light green
07 Pale gray 17 Pale green
08 Dark gray 18 Default list box yellow
09 Dark blue 19 Light yellow

Help number

Syntax: ?x

The "x" is the help ID in the IPF file and is an integer from 1 to 65535. If ? 0 is given, then the help ID is calculated with respect to the field.

The help number is reserved in this way:

Value Reserved
1 <= x = 999 Panel help
1000 = x = 9999 Component help
10000 = x = 19999 Field help (2 byte integer)
20000 = x = 29999 Field help (4 byte integer, real, date and time)
30000 = x = 39999 Field help (Characters)
30001 = x = 65535 General help

Relative character position

This function defines a relative character position as it relates to a current character position. If no value is given, the character position is defined as the current character position.

Relative line position

This function defines the relative line position as it relates to the current line position. If no value is given the position is defined as the current line position.

Control attributes

Control character Add-ons Description Example
C Check box @@24;PEG_ID_suffix;5;7;?0;;;C;*184;1;|;*184;0;
D Default button @@24;\View_now;0;7;?0;- -;;PD;F0;
E (New) Tab button @@24;\Standard;0;7;?0;;;ED;F10021;
I (New) Icon on tab button @@24;\Standard;0;7;?0;;;EiD;F10021;
Fxx Attach to function key xx, xx={2,3,...,12} @@24;Cancel;0;7;?0;;;- PNPF3;T;F3;
H Help button @@24;Help;0;7;?0;;;PH;
K() (New) Hotkey @@24;Print;0;7;?0;"Print...";1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
L01 (New) Link type 1 (bitmap/text push button with no raised border) @@24;Print;0;7;?0;"Print...";;1;SL01TK(CONTROL+P);.ICO=57;CN;F9;
L02 (New) Link type 2 (bitmap/text push button with single border) @@24;Print;0;7;?0;"Print...";;1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
L03 (New) Link type 3 (color) @@24;*100;0;7;?0;"";;;L03;;;*145;1;F2;
L04 (New) Link type 4 (Change the background/ foreground color by holding down the left mouse button and clicking on the field) @@24;\Orders;1;1530;?40500;;;SL04;0931;M;$3;DSCH;
L05 (New) Link type 5 (Like L04,but with a frame) @@24;\Orders;1;1530;?40500;;;SL05;0931;M;$3;DSCH;
L06 (New) Link type 6 (Raises a flat icon when the mouse is placed on the field.) @@24;I60;0;7;?0;"Scenario__(Home)";5;;SL06K(HOME);.ICO=60;CN;F2;
L07 (New) Link type 7 (Used for color buttons) @@24;04;2;00;?0;Color_0;4;;L07T;;;~1;00;F0;
M (New) Pop up menu @@24;Open_resource...__(Alt+O);0;7;;;;Ml;F2;
s (New) Separator line @@24;Print...__(Control+P);0;7;;;;Msl;F9;
b (New) Menu break @@24;Print...__(Control+P);0;7;;;;Mbl;F9;
c (New) Use checkmark @@24;Delay;1;7;;;;Mcl;*33;3;F40;
l (New) Linked to list box @@24;Open_resource...__(Alt+O);0;7;;;;Ml;F2;
w (New) Linked to windows @@24;Update_list__(Control+F);0;7;;;;Mwl;F6;
a (New) Linked to all @@24;Open_resource...__(Alt+O);0;7;;;;Mal;F2;
xx (New) Linked to field number @@24;Delete_log_file...__(Alt+D);0;7;;;;M9;F5;
Np No pointer focus @@24;Cancel;0;7;?0;;;P NPF3;T;F3;
P Push button @@24;OK;0;7;?0;;;P;F0;
i Icon Push button @@24;I20;0;7;?0;;;PINP--;*2;0;F8;
R Radio button @@24;\Delay;1;7;?0;;;R--;*172;2;
S Dynamic size
T (New) Toolbar control @@24;Print;0;7;?0;"Print...";;1;SL02TK(CONTROL+P);.ICO=57;CN;F9;
X Disable if read-only mode @@24;Backup;0;7;?0;;;P- X;F0;

Value field

Shows the values/columns in the list box where the calculations is performed.

Disable action

Syntax: Dx, D+x, D-x

For Dx, "x" is a positive number interpreted as the absolute field number.

For D+x or D-x, "x" is a positive number interpreted as the relative field number to the current field.

Special action

These special actions can be used:
  • RETURN VALUE action

    Syntax: FIELD REFERENCE; VALUE RETURNED

    This action returns values to the field described by the field reference The control character in the field reference gives the field type.

  • REXX call action

    Syntax: Cx

    "x" is the REXX command number with a range from 1 to 99.

    In the start-up CMD file, you can specify environment variables to define the REXX command file attached to the REXX command number, such as SET REXXC1 = C:\REXX\BACKUP.CMD. If no environment variables are defined, then the default REXX command file names are REXXC1.CMD, REXXC2.CMD, and REXXC99.CMD.

  • FUNCTION KEY action

    Syntax: Fx

    where "x" is defined as the function key number to be simulated. It can contain be one or more digits. The action simulates the use of the key and is performed immediately such that the rest of the special function definition is skipped. F0 is treated as if the Enter (Return) key was pressed and F3 is treated as the Escape (Esc) key.

  • PANEL action

    Syntax: Sx

    "x" is a positive number, interpreted here as a panel number. Without returning to the calling program, the panel system handles the panel that is specified in the action as if a call was made to display the panel. You can divide one panel into other panels without changing the calling program.
    Note: The data arrays are the same for the whole series of panels.
  • TERMINATE WINDOW action

    Syntax:T

    The window is terminated.

  • DELAY action

    Syntax: Wx

    Where "x" is a positive number interpreted as a delay in seconds.

    The panel system waits the specified number of seconds before resuming.

Example

#500;1;-1;-2;-3;01;00;79;

@@28;SWT;5;25;100;5;200;Titlebar_text;

@@24;\OK;0;7;?0;;;PD;F0;

_

_Button_example

_

_______$\OK___&