Index Index for
Section 3X
Index Alphabetical
listing for X
Bottom of page Bottom of
page		 

XmConvertUnits(3X)


OSF/Motif


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.


SEE ALSO

  XmSetFontUnits(3X), XmScreen(3X)

Index Index for
Section 3X
Index Alphabetical
listing for X
Top of page Top of
page