


XmFontListGetNextFont(3X)			    XmFontListGetNextFont(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt	- A font list function that allows applications	to
  access the fonts and character sets in a font	list

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  BBoooolleeaann XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt	((_c_o_n_t_e_x_t, _c_h_a_r_s_e_t, _f_o_n_t))
       XXmmFFoonnttCCoonntteexxtt_c_o_n_t_e_x_t;;
       XXmmSSttrriinnggCChhaarrSSeett**_c_h_a_r_s_e_t;;
       XXFFoonnttSSttrruucctt ****_f_o_n_t;;

DESCRIPTION
  XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt	 accesses the character	set and	font for the next
  entry	of the font list. The application first	uses the XXmmFFoonnttLLiissttIInniitt--
  FFoonnttCCoonntteexxtt routine to create	a font list context.  The application then
  calls	XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt repeatedly with the same context.	 Each
  succeeding call accesses the next element of the font	list.  When finished,
  the application calls	XXmmFFoonnttLLiissttFFrreeeeFFoonnttCCoonntteexxtt to free the allocated	font
  list context.

  This routine allocates memory	for the	character set string that must be
  freed	by the application.

  This function	is obsolete and	exists for compatibility with previous
  releases.  It	is replaced by XXmmFFoonnttLLiissttNNeexxttEEnnttrryy.  If	XXmmFFoonnttLLiissttGGeettNNeexxttFFoonntt
  is passed a context that contains a font set entry, it will return the
  first	font of	the font set.  The next	call to	the function will move to the
  next entry in	the font list.

  _c_o_n_t_e_x_tSpecifies the font list context

  _c_h_a_r_s_e_tSpecifies a pointer to	a character set	string;	the routine returns
	 the character set for the current font	list element

  _f_o_n_t	 Specifies a pointer to	a pointer to a font structure; the routine
	 returns the font for the current font list element

RETURN VALUE
  Returns True if the returned values are valid; otherwise, returns False.

RELATED	INFORMATION
  XXmmFFoonnttLLiisstt((33XX)) and XXmmFFoonnttLLiissttNNeexxttEEnnttrryy((33XX)).














