HP 3000 Manuals

Config Function [ HP VPLUS/Windows Programmer's Guide ] MPE/iX 5.0 Documentation

HP VPLUS/Windows Programmer's Guide

Config Function

When a user clicks the Config function, VPLUS/Windows displays the Config
menu, as shown in Figure 3-20. A user can select only the menu commands
that the administrator has authorized in the Allow Options dialog box.

Figure 3-20. Config Menu

The Config menu enables a user or system administrator to choose from the
following commands:

Define Colors Define PC color pairs to use with the Map
Enhancements command.

Map Enhancements Map VPLUS video or color enhancements to PC
color pairs defined from the Define Color Pairs
command.

Define Interface Select PC display and keyboard preferences.

Describe Font Describe the user-installed font.

Configurations defined from these menu commands apply to all applications
or presentation servers that a user starts from a single directory.

Define Colors

Define Colors is used in conjunction with Map Enhancements. Together,
they enable a user to specify PC color pairs for VPLUS video and color
enhancements. To map to color pairs, a user first defines the desired
color pairs using Define Colors, then uses Map Enhancements to map VPLUS
enhancements to the defined color pairs.

The Define Colors dialog box enables a user to:

* View existing color pairs.
* Modify existing color pairs.
* Create new color pairs.

When a user clicks Define Colors, VPLUS/Windows displays a Define Colors
dialog box, as shown in Figure 3-21.

Figure 3-21. Define Colors Dialog Box

Color definitions are based on foreground and background color sets that
consist of three values corresponding to red (R), green (G), and blue (B)
hues. For example, the value 0, 0, 0 represents black, and the value 0,
255, 0 represents green.

Modifying Existing Color Pairs. VPLUS/Windows provides eight reserved
color pairs, VWCOLOR1 through VWCOLOR8. A user can view these color
pairs, but cannot modify these reserved pairs. However, a user can
modify existing unreserved color pairs. To modify an existing color
pair, a user first selects the color pair. VPLUS/Windows responds by
displaying:

* The name of the color pair in the Color Pair Name field.

* A text string with the corresponding foreground and background colors
in the upper right corner color box.

* The corresponding values in the R, G, and B fields.

A user can change the values using the six horizontal scroll bars and
then click Save to save the new values with the existing name or a new
name. A user must provide a new name if the color name originally
selected was one of the VWCOLORn default colors. The VW prefix is
reserved and cannot be used as the prefix for any user-defined color.

Creating New Color Pairs. To create a new color pair, a user enters the
desired color pair name in the Color Pair Name field, moves the scroll
bars until the desired color pair appears in the color box, then clicks
Save to save the color pair. The maximum number of color pairs is 50.
Figure 3-22 shows an example of a new color pair defined as MYCOLOR.

Figure 3-22. User-Defined Color Pair

When finished modifying and creating color pairs, a user clicks Done to
exit the Define Color Pairs dialog box and return to the presentation
server main window. Before returning to the main window, VPLUS/Windows
prompts the user if a modification has not been saved. If the user
returns to the main window without saving the modification, VPLUS/Windows
discards the modification.

Map Enhancements

Map Enhancements enables a user to alter the default color pair mappings
for all of the color-mapped VPLUS enhancement codes. VPLUS/Windows
preserves the distinction among the terminal video enhancements of full
bright, half bright, full bright blinking, and half bright blinking by
mapping the respective VPLUS enhancement codes (NONE, H, B, HB) to color
pairs. VPLUS/Windows also maps the color enhancement codes (1-8) to
color pairs.

When a user clicks Map Enhancements, VPLUS/Windows displays the Map
Enhancements dialog box, as shown in Figure 3-23.

Figure 3-23. Map Enhancements Dialog Box

Mapping an Enhancement. To map an enhancement to a color pair, a user
selects the enhancement from the list box. The enhancement name and
existing color pair name appear in the boxes at the top of the dialog
box. To substitute a color pair other than the existing one, a user
types over the name with the desired color pair name and then clicks
Save. Figure 3-24 shows an example in which a user is changing the HB
enhancement mapping from the color pair VWCOLOR5 to the color pair
MYCOLOR.

Figure 3-24. User-Defined Enhancement Mapping

When finished mapping the enhancements, a user clicks Done to exit the
Map Enhancements dialog box and return to the presentation server main
window.

Selecting Precedence. The VPLUS enhancements defined for a field, the
error enhancement, or the window line can contain both video and color
enhancement codes. If one of these form components is enhanced with two
color-mapped VPLUS enhancement codes, a user must select a precedence
policy for resolving the conflicting color-mapped enhancements. If a
form component does not have a color enhancement code, precedence does
not apply. In this case, HB is the only combination of two color-mapped
enhancement codes. The HB video enhancement combination is defined with
its own color mapping to prevent conflict between H and B.

If a form component does not have a color-mapped video enhancement code,
precedence does not apply and the color enhancement code mapping is used.
Precedence does apply, however, if H, B, or HB are combined with one of
the color codes (1-8).

Precedence does not apply to key labels, because a color code is the only
enhancement code that can be defined for key labels in a VPLUS forms
file.

The Map Enhancements dialog box provides a box at the bottom of the
window to indicate whether video enhancement codes or color codes should
take precedence. A user selects Enhancement if the video enhancement
code equivalent should take precedence over the color code equivalent. A
user selects Color if the color code should take precedence over the
video enhancement code. For instance, a VPLUS field definition of HI4
with Enhancement precedence maps to the H color mapping with inversion.
Similarly, a VPLUS field definition of HI4 with Color precedence maps to
the color enhancement code 4 color mapping with inversion.

Define Interface

Define Interface enables a user or administrator to select preferences
for certain display and keyboard characteristics. When a user clicks
this menu command, VPLUS/Windows displays the Define Interface dialog
box, as shown in Figure 3-25.

Figure 3-25. Define Interface Dialog Box

Table 3-3 lists each option and the choices available for each option.

Table 3-3. Interface Options

---------------------------------------------------------------------------------------------
| | |
| Options | Choices |
| | |
---------------------------------------------------------------------------------------------
| | |
| Field Cursor | Specifies whether the field cursor is an underlined blinking cursor |
| | or an inverse video box cursor. The default is an underlined |
| | blinking cursor. |
| | |
---------------------------------------------------------------------------------------------
| | |
| Bell | Specifies whether or not the VPLUS bell should sound. The default |
| | is to have the bell sound. |
| | |
---------------------------------------------------------------------------------------------
| | |
| Enter Key | Specifies which key to use as the Enter key. The default key is |
| | the + key in the numeric keypad. Note that VPLUS/Windows also |
| | provides a display version of an Enter key in the application |
| | window between function key labels four and five that can be |
| | activated with a mouse. |
| | |
---------------------------------------------------------------------------------------------

A user clicks Save to keep changed option settings and can subsequently
click Default to revert to the VPLUS/Windows default option settings, if
desired.

Describe Font

Describe Font enables a user or administrator to specify the following
font characteristics for the application window:

* The face name for the base font and a corresponding line drawing
font.

* The height and width of the font.

VPLUS/Windows chooses all other font characteristics. The face names,
height, and width default to values corresponding to the font supplied
with VPLUS/Windows. Refer to Appendix B for information about the
supplied fonts.

When a user clicks Describe Font, VPLUS/Windows displays the Describe
Font dialog box, as shown in Figure 3-26.

Figure 3-26. Describe Font Dialog Box

A user specifies the appropriate characteristics, then clicks Save. To
reset values to the VPLUS/Windows defaults, a user first clicks Default,
then clicks Save.
After a user clicks Save, the presentation server displays a dialog box
with the message Restart the Presentation Server to use the new
specifications. After reading the message, a user clicks OK to return to
the main window.

Using Screen Fonts. VPLUS/Windows controls the font used in the
application window by passing a description of the desired font to
Microsoft Windows. Microsoft Windows maps the VPLUS/Windows description
of the font to a system font that most closely matches the described
font.

You must first install the desired screen font into the windowing system
using the Control Program in the Microsoft Windows Program Manager.
Refer to the Microsoft Windows User's Guide (SY06851-0290) for
information about installing a screen font. Any font you install must
conform to the font description passed by VPLUS/Windows in order to
qualify as the closest match. Refer to the Microsoft Windows Software
Development Kit-Reference (SY0302a-300-R00-1089) for the scheme used for
mapping font characteristics to a font on the system.

Table 3-4 lists all of the Microsoft Windows font parameters and the
corresponding values that VPLUS/Windows uses. Note that you can modify
only the first three parameters: height, width, and face name.

Table 3-4. Corresponding VPLUS/Windows Values for Microsoft Windows Font Parameters

--------------------------------------------------------------------------------------------
| | |
| Microsoft Windows Font | VPLUS/Windows Value |
| Parameter | |
| | |
--------------------------------------------------------------------------------------------
| | |
| Height | 10 (VPLUS/Windows default) |
| | |
--------------------------------------------------------------------------------------------
| | |
| Width | 7 (VPLUS/Windows default) |
| | |
--------------------------------------------------------------------------------------------
| | |
| Face Name | VWROMAN8 and VWLINEDR (VPLUS/Windows default) |
| | |
--------------------------------------------------------------------------------------------
| | |
| Pitch/Family | Fixed |
| | |
--------------------------------------------------------------------------------------------
| | |
| Character Set | ANSI |
| | |
--------------------------------------------------------------------------------------------
| | |
| Escapement | 0 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Orientation | 0 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Weight | 400 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Italic | 0 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Underline | 0 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Strike Out | 0 |
| | |
--------------------------------------------------------------------------------------------
| | |
| Output Precision | The Microsoft default |
| | |
--------------------------------------------------------------------------------------------
| | |
| Clip Precision | The Microsoft default |
| | |
--------------------------------------------------------------------------------------------
| | |
| Quality | Proof |
| | |
--------------------------------------------------------------------------------------------

Font Restrictions. The base font and line drawing font have the
following restrictions when used with VPLUS/Windows:

* The base font used in the application window must correspond to the
character set(s) that VPLUS/Windows supports on the
HP 3000. Refer to the section "Native Language Support" in Chapter 2
for more information.

* The application window font must be a fixed pitch (mono-spaced) font.
Proportional spacing is not meaningful for VPLUS forms designed with
FORMSPEC.

* The line drawing font must have the same height and width as the base
font. The translation utility retains all drawing characters that
the forms designer included in the original VPLUS forms file.

MPE/iX 5.0 Documentation