GUI ScreenIO for Windows

 ScreenIO.com


Control Attributes

All controls have attributes associated with them.  

Attributes control the behavior of the controls when your panel is displayed, and return information about your controls to you when GUI ScreenIO returns to your program.  Four attributes are associated with each control; the attributes reside in the -1 portion of the panel copybook.

The attribute names are the name of your COBOL field, plus a suffix.  This makes it easy to use them, since the name of the attribute for any given control is obvious.  Here's what the attributes look like for a field named myfieldname:

 01 panel-1.
        .
        .
       15 myfieldname-A.
         20 myfieldname-P       PIC X.
         20 myfieldname-C       PIC XX.
         20 myfieldname-O       PIC X.
         20 myfieldname-M       PIC X.


myfieldname-P is the paint attribute.

The paint attribute is used primarily to tell GUI ScreenIO which control should be active when your panel is displayed, or to mark errors.  On return from GUI ScreenIO, it will tell you which control was active when GUI ScreenIO returned to your program.  It can also tell you when a control causes GUI ScreenIO to return to your program.

On the call to GUI ScreenIO to display your panel:

Value Action
C Makes this the active control when the panel is displayed.
E Marks the control the error color (if applicable).
I Makes this the active control when the panel is displayed and sets the insert point at the offset specified in panel-INSERT-POINT.
- Any other value; no action.

On return from GUI ScreenIO::

Value Significance
- Default value (LOW-VALUE); nothing significant happened.
A This control was the active control.
F This control's definition requires it to cause GUI ScreenIO to return to your program (Hot Field) when the Field became Full. 
H This control's definition requires it to cause GUI ScreenIO to return to your program in some situations, (Hot Field) and such a condition was detected. 

These conditions are such things as, return when the control becomes active, return when you leave the control, return when the control is changed, and so on. 


myfieldname-C is the color attribute.

The color attribute is used to override the color of a field that was specified in the panel editor.  

On the call to GUI ScreenIO to display your panel:

Value Action
0 Use the default color.
xx A named color value.  

You define a set of foreground/background color combinations by name in the panel editor, and then simply move the one you want - by name - to the field's color attribute to change the color of the field's contents.

1-255 Only for backward compatibility with applications converted from Legacy ScreenIO.  Assigns this color number to the control.  New applications should use named colors.

On return from GUI ScreenIO::

Value Significance
- Unchanged.

myfieldname-O is the option attribute.

The option attribute is used to make a control protected or invisible. 

On the call to GUI ScreenIO to display your panel:

Value Action
P Makes the control protected (you can't alter its contents).
I Makes the control invisible (and protected).
R Sets Edit Controls to ReadOnly, and disables tabbing into this control, prevents typing in the control, but allows copy operations.

Note:  Honored only for Edit Controls, Multi-Line Edit Controls, and Validated Edit Controls.

- Any other value; no action.

On return from GUI ScreenIO:

Value Significance
- If value is Valid (as defined above), it will be returned unchanged. Invalid values will be returned as low-values.

myfieldname-M is the miscellaneous attribute.

On the call to GUI ScreenIO to display your panel:

Value Action
- Presently unused.

On return from GUI ScreenIO::

Value Significance
- Default value (LOW-VALUE); nothing significant about this control.
M The control content was modified by the user.

© 2000-2019 Norcom, all rights reserved 

TOC

Send feedback to Norcom