XmConvertUnits(Xm)

Syntax

#include <Xm/Xm.h>

int XmConvertUnits (widget, orientation, from_unit_type,
		    from_value, to_unit_type)
Widget widget;
int orientation;
int from_unit_type;
int from_value;
int to_unit_type;

Description

widget

Specifies the widget for which the data is to be converted

orientation

Specifies whether the converter uses the horizontal or vertical screen resolution when performing the conversions. orientation can have values of XmHORIZONTAL or XmVERTICAL.

from_unit_type

Specifies the current unit type of the supplied value

from_value

Specifies the value to be converted

to_unit_type

Converts the value to the unit type specified

The parameters from_unit_type and to_unit_type can have the following values:

• XmPIXELS -- all values provided to the widget are treated as normal pixel values. This is the default for the resource.

• Xm100TH_MILLIMETERS -- all values provided to the widget are treated as 1/100 millimeter.

• Xm1000TH_INCHES -- all values provided to the widget are treated as 1/1000 inch.

• Xm100TH_POINTS -- all values provided to the widget are treated as 1/100 point. A point is a unit typically used in text processing applications and is defined as 1/72 inch.

• Xm100TH_FONT_UNITS -- all values provided to the widget are treated as 1/100 of a font unit. A font unit has horizontal and vertical components. These are the values of the XmScreen resources XmNhorizontalFontUnit and XmNverticalFontUnit.

Return value

See also