XmConvertUnits(Xm)
XmConvertUnits --
a function that converts a value in one unit type to another unit type
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
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 value
Returns the converted value.
If a NULL widget, incorrect orientation, or incorrect
unit_type is supplied as parameter data, 0 is returned.
See also
XmSetFontUnits(Xm)
and
XmScreen(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003