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

FreeBSD Manual Pages

  
 
  

home | help
XmStringTableProposeTablistLibrary Functions ManXmStringTableProposeTablist(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).

						XmStringTableProposeTablist(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

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

home | help