XmConvertUnits(3X) SDK X11 R4.11MU05 XmConvertUnits(3X)
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, fromunittype,
fromvalue, tounittype)
Widget widget;
int orientation;
int fromunittype;
int fromvalue;
int tounittype;
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.
fromunittype
Specifies the current unit type of the supplied value
fromvalue Specifies the value to be converted
tounittype
Converts the value to the unit type specified
The parameters fromunittype and tounittype 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 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 unittype is supplied as parameter data, 0
is returned.
RELATED INFORMATION
XmSetFontUnits(3X) and XmScreen(3X).
Licensed material--property of copyright holder(s)