[WINDOWS]

[WINDOWS]
type = "caption", (x, y, width, height), sizing,
(clientRGB), (nonscrollRGB)
.
.
.

The [WINDOWS] section defines the size, location, and colors for the primary Help window and any secondary-window types used in a help file.

The secondary windows defined in this section are intended to be used with Windows applications that specify secondary windows when calling the WinHelp function.

Parameters

type

Specifies the type of window that uses the defined attributes. For the primary Help window, this parameter is main. For a secondary window, this parameter may be any unique name of up to 8 characters. Any jumps that display a topic in a secondary window give this type name as part of the jump.

caption

Specifies the title for a secondary window. Windows Help places the title in the title bar of the window. To set the title for the primary Help window, use the TITLE option in the [OPTIONS] section.

x

Specifies the x-coordinate, in help units, of the window's upper-left corner. Windows Help always assumes the screen is 1024 help units wide, regardless of resolution. For example, if the x-coordinate is 512, the left edge of the Help window is in the middle of the screen.

y

Specifies the y-coordinate, in help units, of the window's upper-left corner. Windows Help always assumes the screen is 1024 help units high, regardless of resolution. For example, if the x-coordinate is 512, the top edge of the Help window is in the middle of the screen.

width

Specifies the default width, in help units, for a secondary window.

height

Specifies the default height, in help units, for a secondary window.

sizing

Specifies the relative size of a secondary window when Windows Help first opens the window. This parameter can be one of the following values:

Value Meaning

0 Set the window to the size specified by the x, y, width, and height parameters.
1 Maximize the window; ignore the x, y, width, and height parameters.

clientRGB

Specifies the background color of the window. This parameter is an RGB color value consisting of three 8-bit hexadecimal numbers enclosed in parentheses and separated by commas. If this parameter is not given, Windows Help uses the default window color specified by Control Panel.

nonscrollRGB

Specifies the background color of the non-scrolling region (if any) in the Help window. This parameter is an RGB color value consisting of three 8-bit hexadecimal numbers enclosed in parentheses and separated by commas. If this parameter is not given, Windows Help uses the default window color specified by Control Panel.

Example

The following example defines two windows, the main window and a secondary window named “picture”. The main-window definition sets the background color of non-scrolling regions in the main Help window to (128, 0, 128) but leaves several other values empty (for which Windows Help will supply its own default values). The secondary-window definition sets the caption to “Samples” and sets the width and height of the window to about one-quarter of the width and height of the screen. The background colors for the window and non-scrolling region are (0, 255, 255) and (255, 0, 0), respectively. The sizing parameter for both the main and secondary windows is zero.

[WINDOWS]
main=, (, , , ), 0, (, , ), (128, 0, 128)
picture = "Samples", (123, 123, 256, 256), 0, (0, 255, 255), (255, 0, 0)

See Also

[Options], TITLE