XmConvertUnits(X3mot)

XmConvertUnits -- a function that converts a value in one unit type to another unit type

Synopsis

#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

XmConvertUnits converts the value and returns it as the return value from the function.

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 values

Returns the converted value. If a NULL widget, incorrect orientation, or incorrect unit_type is supplied as parameter data, 0 is returned.

References

XmSetFontUnits(X3mot) and XmScreen(X3mot).