XmConvertUnits(Xm) UNIX System V
NAME
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. 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.
⊕ Xm100THMILLIMETERS - all values provided to the widget
are treated as 1/100 millimeter.
⊕ Xm1000THINCHES - all values provided to the widget are
treated as 1/1000 inch.
⊕ Xm100THPOINTS - 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.
⊕ Xm100THFONTUNITS - all values provided to the widget
are treated as 1/100-font unit. The value to be used for
the font unit is determined in one of two ways. The
resource XmNfont can be used in a defaults file or on the
command line. The standard command line options of -fn
and -font can also be used. The font unit value is taken
as the QUADWIDTH property of the font. The function
XmSetFontUnits allows applications to specify the font
unit values.
RETURN VALUE
Returns the converted value.
ERRORS
If a NULL widget, incorrect orientation, or incorrect
unit_type is supplied as parameter data, 0 is returned.
RELATED INFORMATION
XmSetFontUnit(Xm)
(printed 2/14/90) XmConvertUnits(Xm)