XmConvertUnits(3X)XmConvertUnits(3X)NAMEXmConvertUnits — 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;
VERSION
This page documents version 1.2 of the Motif library.
DESCRIPTIONXmConvertUnits converts the value and returns it as the return value
from the function. Specifies the widget for which the data is to be
converted Specifies whether the converter uses the horizontal or verti‐
cal screen resolution when performing the conversions. orientation can
have values of XmHORIZONTAL or XmVERTICAL. Specifies the current unit
type of the supplied value Specifies the value to be converted 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 nor‐
mal pixel values. This is the default for the resource. Xm100TH_MIL‐
LIMETERS—all values provided to the widget are treated as 1/100 mil‐
limeter. 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 pro‐
cessing 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 val‐
ues of the XmScreen resources XmNhorizontalFontUnit and XmNvertical‐
FontUnit.
RETURN VALUE
Returns the converted value. If a NULL widget, incorrect orientation,
or incorrect unit_type is supplied as parameter data, 0 is returned.
RELATED INFORMATIONXmSetFontUnits(3X) and XmScreen(3X).
XmConvertUnits(3X)