PixelsToUnits

Description

Converts pixels to PowerBuilder units. Because pixels are not usually square, you also specify whether you are converting the pixels' horizontal or vertical measurement.

Syntax

PixelsToUnits ( pixels, type )

Argument

Description

pixels

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

type

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

  • XPixelsToUnits! -- Convert the pixels in the horizontal direction.

  • YPixelsToUnits! -- Convert the pixels 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, PixelsToUnits 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 35 horizontal pixels to PowerBuilder units and set the variable Value equal to the converted value:

long Value
Value = PixelsToUnits(35, XPixelsToUnits!)

See also

UnitsToPixels