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

FreeBSD Manual Pages

  
 
  

home | help
XmStringTa...poseTablist(3) Library Functions Manual XmStringTa...poseTablist(3)

NAME
     XmStringTableProposeTablist  --  A  convenience function that returns a tab
     list

SYNOPSIS
     #include <Xm/Xm.h>
     XmTabList XmStringTableProposeTablist(
     XmStringTable strings,
     Cardinal num_strings,
     Widget widget,
     float pad_value,
     XmOffsetModel offset_model);

DESCRIPTION
     XmStringTableProposeTablist takes	an  XmStringTable  structure  containing
     tabbed  compound  strings, information on padding between columns, and ren-
     dering information and returns a tab list	that,  if  used  to  render  the
     strings in the table, would cause the strings to line up in columns with no
     overlap and with the specified amount of padding between the widest item in
     each column and the start of the next column. Each tab in the tablist would
     have  the	same unit type as units, an offset model of offset_model, and an
     alignment type of XmALIGNMENT_BEGINNING.

     strings   Specifies an array of compound strings.

     num_strings
	       Specifies the number of compound strings in strings.

     widget    Specifies the widget used for deriving any necessary  information
	       for  creating  the  rendition.  In particular, the XmNunitType of
	       widget will be used to specify the unit type to be used in deter-
	       mining the amount of padding separating columns and for the  tabs
	       in  the	proposed  tab  list. Also, widget's render table will be
	       used in interpreting rendition tags within the strings.

     pad_value Specifies the value of the amount of padding to be used to  sepa-
	       rate  columns.  The units for this parameter are specified as the
	       XmNunitType set for the widget parameter.  Refer to the	XmNunit-
	       Type  resource  of the XmGadget, XmManager, or XmPrimitive refer-
	       ence page.

     offset_model
	       Specifies the offset model to be used in creating the  tabs.  Can
	       be XmABSOLUTE or XmRELATIVE.

RETURN
     Returns a new XmTabList.  The function allocates space to hold the returned
     tab list.	The application is responsible for managing the allocated space.
     The application can recover the allocated space by calling XmTabListFree.

RELATED
     XmTabList(3) and XmTabListFree(3).

						     XmStringTa...poseTablist(3)

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

home | help