


XmFontListCreate(3X)					 XmFontListCreate(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoonnttLLiissttCCrreeaattee - A font list function that creates a font list

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  XXmmFFoonnttLLiisstt XXmmFFoonnttLLiissttCCrreeaattee ((_f_o_n_t, _c_h_a_r_s_e_t))
       XXFFoonnttSSttrruucctt * _f_o_n_t;;
       XXmmSSttrriinnggCChhaarrSSeett_c_h_a_r_s_e_t;;

DESCRIPTION
  XXmmFFoonnttLLiissttCCrreeaattee creates a new font list with	a single element specified by
  the provided font and	character set.	It also	allocates the space for	the
  font list.

  NNoottee::	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tAAppppeennddEEnnttrryy.

  _f_o_n_t	 Specifies a pointer to	a font structure for which the new font	list
	 is generated.	This is	the structure returned by the XLib XXLLooaadd--
	 QQuueerryyFFoonntt function.

  _c_h_a_r_s_e_tSpecifies the character set identifier	for the	font.  This can	be
	 XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT, but this value does not comply with the
	 AES, and it may be removed in future versions of Motif.  If the
	 value is XXmmSSTTRRIINNGG__DDEEFFAAUULLTT__CCHHAARRSSEETT, the	routine	derives	the character
	 set from the current language environment.

RETURN VALUE
  Returns NULL if _f_o_n_t or _c_h_a_r_s_e_t is NULL; otherwise, returns a	new font
  list.

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tAAppppeennddEEnnttrryy((33XX)).























