[Contents]
[Index]
[Next]
[Previous]
XmConvertUnits
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. 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.
RELATED INFORMATION
XmSetFontUnits(3X) and
XmScreen(3X).