Ideally, you could simply modify your program to use graphical features, and that program would then run perfectly under both graphical and character systems. However, this is usually not the case. The key problems arise in the different physical traits associated with graphical and character systems. Let's examine some of the primary differences.
For character systems, you can generally assume that you have a screen area of 24 or 25 lines by 80 columns. While you can occasionally find larger screens (for example, many Xterm configurations), designing your programs for 24 by 80 will guarantee nearly universal compatibility. (Some programmers use 25 lines instead because this is the number of lines normally provided on IBM PC compatibles, as well as many common terminals. The discussion below uses 24 lines because it is traditionally the most portable value. If you use 25 lines instead, the discussion still applies, but the problems that arise during the conversion to a graphical system are more obvious.)
The display characteristics of graphical systems are harder to analyze. Looking at current Microsoft Windows systems, they are usually configured with one of these screen resolutions: 640 x 480, 800 x 600, or 1024 x 768. You can find other sizes too, but these account for the vast majority. Now, translate these values into character cells to see how they compare with character systems. The FIXED-FONT used by ACUCOBOL-GT is usually designed to be 8 pixels wide by 15 pixels high. On a 640 x 480 screen, this gives exactly 80 characters across (assuming the window borders are placed off of the screen) and 42 characters high (in practice, somewhat less because of space used by the window's title and menu). This size works fine with a 24 x 80 layout, and so simply running a character-based program under Windows works fine.
However, problems arise when you convert that character-based program to use graphical controls. Consider what happens when you convert text-based data entry fields into ENTRY-FIELD controls. Typically, entry fields are boxed (have a border around them) so that they match the normal look of a Windows application, and they usually display using the DEFAULT-FONT (a proportional font). The DEFAULT-FONT is normally 13 pixels high by 7 pixels wide. Making the entry fields boxed adds 50% to their height, with the result that they are 20 pixels high. This gives exactly 24 lines on a 640 x 480 screen, but only if you omit all of the window borders, the title and menu, and assuming that you do not include any spacing between the entry fields. If you want to add a 3-D look to the entry fields, you need at least another 3 pixels, making 24 lines approximately 552 pixels high (again, ignoring the window title and other features). In practice, you will usually want to be able to see the window's title, and its menu and toolbar (if any). This adds approximately 20 to 40 pixels depending on how many elements are present. As a result of these conditions, you cannot assume that you have 24 lines available on a 640 x 480 system when you include graphical controls.
Thus, the first major problem can be summarized as follows:
Differences in the physical dimensions of controls also cause problems in placing them. Consider entry fields again. On a character-based system, entry fields are one line tall. On a graphical system, they are 1.5 lines tall. ACUCOBOL-GT has a feature to account for this difference, but there are also problems in horizontal positioning that are harder to account for. For example, two radio buttons placed side-by-side might look great on a graphical screen, but they may overlap when displayed on a character screen. This happens because of the effects of shifting from a proportionally sized font to a fixed-size font.
Now consider a FRAME control. On a graphical system, the frame is drawn around the area that it occupies (except for the top line, which is adjusted to account for the frame's title). On a character system, the frame is drawn in the middle of the character cells forming the edge of the frame, because that is the best positioning that a character system can perform. A frame that is two lines high on a graphical system has enough space inside it to hold one line of text. On a character system, a two line high frame has no space inside it to hold anything.
Thus the second major problem is:
Help topics in this section discuss various approaches to managing these issues. While there is no single solution to all the cases, ACUCOBOL-GT offers a variety of ways to handle these problems.