XmConvertUnits - Man Page

#include <Xm/Xm​.h>
int XmConvertUnits(
Widget widget,
int orientation,
int from_unit_type,
int from_value,
int to_unit_type);

XmConvertUnits converts the value and returns it as the return value from the function​. For resources of type, dimension, or position, you can specify units using the syntax described in the XmNunitType resource of the XmPrimitive reference page​.

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​. The orientation parameter 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 pixel values​. This is the default for the resource​.

XmMILLIMETERS

All values provided to the widget are treated as millimeter values​.

Xm100TH_MILLIMETERS

All values provided to the widget are treated as 1/100 of a millimeter​.

XmCENTIMETERS

All values provided to the widget are treated as centimeter values​.

XmINCHES

All values provided to the widget are treated as inch values​.

Xm1000TH_INCHES

All values provided to the widget are treated as 1/1000 of an inch​.

XmPOINTS

All values provided to the widget are treated as point values​. A point is a unit used in text processing applications and is defined as 1/72 of an inch​.

Xm100TH_POINTS

All values provided to the widget are treated as 1/100 of a point​. A point is a unit typically used in text processing applications and is defined as 1/72 of an inch​.

XmFONT_UNITS

All values provided to the widget are treated as normal font units​. A font unit has horizontal and vertical components​. These are the values of the XmScreen resources XmNhorizontalFontUnit and XmNverticalFontUnit​.

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​.

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

XmPrimitive, XmSetFontUnits(3), and XmScreen(3)​.