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 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. Returns the converted value if it succeeds and -1 if an error occurs. If any argument's value is null, PixelsToUnits returns null.

Examples

These statements convert 35 horizontal pixels to PowerBuilder units and set the variable Value equal to the converted value:

integer Value
Value = PixelsToUnits(35, XPixelsToUnits!)

See also

UnitsToPixels