UnitsToPixels

Description

Converts PowerBuilder units to pixels and reports the measurement. Because pixels are not usually square, you also specify whether to convert in the horizontal or vertical direction.

Syntax

UnitsToPixels ( units, type )

Argument

Description

units

An integer or long whose value is the number of PowerBuilder units you want to convert to pixels

type

A value of the ConvertType enumerated datatype indicating how to convert the value:

  • XUnitsToPixels! -- Convert the units in the horizontal direction

  • YUnitsToPixels! -- Convert the units in the vertical direction


Return value

Integer or long.

Returns the converted value if it succeeds and -1 if an error occurs. If any argument's value is null, UnitsToPixels returns null.

If the value of the first argument is an integer type, then the return value is an integer type; if the value of the first argument is a long type, then the return value is a long type; if the value of the first argument is a numeric value, then the return value is a long type by default.

Examples

These statements convert 350 vertical PowerBuilder units to vertical pixels and set value equal to the converted value:

long Value
Value = UnitsToPixels(350, YUnitsToPixels!)

See also

PixelsToUnits