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.

Returns

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

Example 1

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