Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmConvertUnits(3)	   Library Functions Manual	     XmConvertUnits(3)

NAME
       XmConvertUnits  -- A function that converts a value in one unit type to
       another unit type

SYNOPSIS
       #include	<Xm/Xm.h>
       int XmConvertUnits(
       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.  For	resources of type, dimension, or position, you
       can specify units using the syntax described  in	 the  XmNunitType  re-
       source of the XmPrimitive reference page.

       widget	 Specifies the widget for which	the data is to be converted.

       orientation
		 Specifies whether the converter uses the horizontal or	verti-
		 cal  screen  resolution  when performing the conversions. The
		 orientation parameter 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  pixel  val-
		 ues. This is the default for the resource.

       XmMILLIMETERS
		 All  values  provided to the widget are treated as millimeter
		 values.

       Xm100TH_MILLIMETERS
		 All values provided to	the widget are treated as 1/100	 of  a
		 millimeter.

       XmCENTIMETERS
		 All  values  provided to the widget are treated as centimeter
		 values.

       XmINCHES	 All values provided to	the widget are treated as inch values.

       Xm1000TH_INCHES
		 All values provided to	the widget are treated as 1/1000 of an
		 inch.

       XmPOINTS	 All values provided to	the widget are treated as  point  val-
		 ues.  A  point	is a unit used in text processing applications
		 and is	defined	as 1/72	of an inch.

       Xm100TH_POINTS
		 All values provided to	the widget are treated as 1/100	 of  a
		 point.	  A  point is a	unit typically used in text processing
		 applications and is defined as	1/72 of	an inch.

       XmFONT_UNITS
		 All values provided to	the widget are treated as normal  font
		 units.	 A  font  unit has horizontal and vertical components.
		 These are the values of the XmScreen resources	XmNhorizontal-
		 FontUnit and XmNverticalFontUnit.

       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	compo-
		 nents.	 These are the values of the XmScreen  resources  XmN-
		 horizontalFontUnit and	XmNverticalFontUnit.

RETURN
       Returns	the converted value.  If a NULL	widget,	incorrect orientation,
       or incorrect unit_type is supplied as parameter data, 0 (zero)  is  re-
       turned.

RELATED
       XmPrimitive, XmSetFontUnits(3), and XmScreen(3).

							     XmConvertUnits(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmConvertUnits&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help