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

FreeBSD Manual Pages

  
 
  

home | help
XmStringT...oseTablist(3)  Library Functions Manual  XmStringT...oseTablist(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
       rendering  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 informa-
		 tion  for creating the	rendition. In particular, the XmNunit-
		 Type of widget	will be	used to	specify	the unit  type	to  be
		 used  in determining 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
		 separate columns.  The	units for this parameter are specified
		 as  the  XmNunitType  set for the widget parameter.  Refer to
		 the XmNunitType resource of the XmGadget, XmManager,  or  Xm-
		 Primitive reference 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  re-
       turned tab list.	 The application is responsible	for managing the allo-
       cated  space.  The application can recover the allocated	space by call-
       ing XmTabListFree.

RELATED
       XmTabList(3) and	XmTabListFree(3).

						     XmStringT...oseTablist(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+14.3.quarterly>

home | help