Presentation Parameters Statement

The optional PRESPARAMS statement is used to define presentation parameters. The syntax of the PRESPARAMS statement is as follows.

                                 ┌─────,───┐
                                 │         │
                                          │
 ───PRESPARAMS────type───,────────value──┴─

A presentation parameter consists of:

type (ULONG)

The presentation parameter attribute type. See the PARAM data type for a description of valid types.

A string can be used to specify the type for a user type. If this is done, the string type is converted into a string atom when the dialog template is read into memory. Thereafter, this presentation parameter is referred to by this string atom. The application can use the atom manager API to match the string and the string atom.

value (LONG or PSZ)
One or more values depending upon the attribute type.

If the value is enclosed in quotes it is a zero-terminated string. Otherwise, it is converted to a LONG. There may be more than one value, depending upon the type. See PARAM data type for a description of the values required for system-defined presentation parameters.

Examples

The following are examples of PRESPARAMS statements:

PRESPARAMS PP_BORDERCOLOR,  0x00ff00ffL
PRESPARAMS PP_FONTNAMESIZE, "12.Helv"
PRESPARAMS "my color",      0x00ff00ffL
PRESPARAMS "my param",      0, 1, 2, 3, "Hi there"

---

[Back: Control Data Statement]
[Next: Parent/Child/Owner Relationship]