[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:

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).