Progress
Portability Guide


Windows Environment Settings

When you install Progress on Windows, the installation program automatically places default progress.ini information into the registry. Depending upon which prowin32 parameters you specify for startup, Progress searches for either the registry or the progress.ini file. For more information on the registry, see the chapter on maintaining user environments in the Progress Client Deployment Guide .

Progress Software recommends that you modify the Windows environment settings by modifying the progress.ini file. You can change the default settings and add your own customized sections. Note that after each modification of this file, you must run the INI2REG utility, which places progress.ini information into the registry.

The progress.ini file contains sections created by Progress for unique purposes. For example, the [Proedit] section is read by the Procedure Editor. Sections are also platform specific. For example, character client executables read information stored only in the [WinChar Startup] section while the Windows graphical client executables read information stored only in the [Startup] section.

As installed, the progress.ini file contains the following sections:

When Progress searches for environment settings at startup, it first searches the registry, unless the session started with a startup parameter that told Progress to start searching for an initialization file. Progress then searches for an initialization file in the following places:

  1. The current working directory (as defined in the Working Directory field in the Program Item properties sheet)
  2. The Windows directory
  3. The directory that contains the Progress executable
  4. The user’s path

This search order fosters deployment flexibility because you can:

Startup Specifications

The [Startup] section specifies the following:

For more information on these startup specifications, see the chapter on user-interface environments in the Progress Client Deployment Guide .

Font Specifications in Startup

These are the font settings in the [Startup] and [WinChar Startup] sections:

DefaultFont=MS Sans Serif, size 8
DefaultFixedFont=CourierNew 

Available Fonts

There are font table entries for the Progress ADE tools. Progress uses the default system fonts defined in the [Startup] and [WinChar Startup] sections, unless you add additional fonts to the existing font table.

NOTE: Do not change fonts 0 through 7; this could cause the Progress ADE tools to malfunction.

Determine which screen fonts exist in your environment and choose fonts by using the Font common dialog box or by viewing the font settings in the registry.

Once you have selected fonts, add them to the font table using the following syntax:

SYNTAX
fontN=typeface,
  { size point size, keyword, script+scriptname } 

N

An integer that specifies the font table entry.

typeface

A valid typeface name, such as Times or Courier.

point size

The size of the font, in points. If you omit the point size, Progress uses the default point size as defined by the typeface.

keyword

You can optionally specify bold, italic, underline, or strikeout.

For example, add 15 point Times to font table entry 16 as follows, and separate typeface and keyword with a comma:

font16=Times, size 15, bold 

You can also add fonts to the font table using the following formats:

fontN=DefaultFont
fontN=DefaultFixedFont 

Your font table can contain up to 256 entries. Each entry in the table performs two semantic functions: it names a font that exists in your environment and it maps that font to an integer from 0 to 255. The integer is the way an application references the font when making a font assignment.

Available Colors

At run time, Progress stores color specifications in a data structure called the color table. The color table is initialized from the [Colors] and [WinChar Colors] sections. There are 16 colors available to an application for use as either foreground or background colors. You can add up to 256 colors.

Each entry in the [Colors] and [WinChar Colors] sections performs two semantic functions: it defines a color by name or RGB value and maps that color to an integer from 0 to 255. The integer is the way an application references the color when making color assignments to a widget.

A color entry has the following syntax:

SYNTAX
colorN={R,G,B | color-name} 

N

An integer from 0 to 255 that specifies the color table entry.

R

An integer that specifies the amount of red present in the color.

G

An integer that specifies the amount of green present in the color.

B

An integer that specifies the amount of blue present in the color.

color-name

Any of the following color names, mapped to the colors defined on your Windows system:

COLOR-SCROLLBAR
COLOR-BACKGROUND
COLOR-ACTIVECAPTION
COLOR-INACTIVECAPTION
COLOR-MENU
COLOR-WINDOW
COLOR-WINDOWFRAME
COLOR-MENUTEXT
COLOR-WINDOWTEXT
COLOR-CAPTIONTEXT
COLOR-ACTIVEBORDER
COLOR-INACTIVEBORDER
COLOR-APPWORKSPACE
COLOR-HIGHLIGHT
COLOR-HIGHLIGHTTEXT
COLOR-BTNFACE
COLOR-BTNSHADOW
COLOR-GRAYTEXT
COLOR-BTNTEXT
COLOR-INACTIVECAPTIONTEXT
COLOR-BTNHIGHLIGHT 

For example, the following entry specifies red at color table entry 4:

color4=128,0,0 

Any entries you add to the color table must be sequential. For example, since the installed environment defines color0 through color15, the next color you add must be color16. If you mistakenly add an entry for color17, Progress ignores it if color16 is undefined.

For backward compatibility, color0 through color15, as installed, are the same as the colors supported in previous versions. See the Progress Programming Handbook for a list of these colors.

Windows Color Palette

Many VGA and Super VGA video cards provide 256-color palettes for the Windows environment. The following restrictions apply to the use of color palettes on Windows:

Some video cards provide either HI-COLOR or TRUE-COLOR interfaces for Windows. The HI-COLOR interface provides 65,536 colors, and the TRUE-COLOR interface provides 16,777,216 colors. These two interfaces do not use palettes and therefore do not impose the same restrictions on color use. These are the features provided by these environments:

Windows Color Bitmaps

Progress supports 256-color bitmaps for buttons and images. Each 256-color bitmap has a list of palette entries associated with it. When you display one of these bitmaps in a Progress window, the palette entries are appended to the existing Progress palette.

The following rules and restrictions apply:

Main Window Defaults

The [Default Window] section of the environment file specifies the following for a Windows application’s default window:


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095