


XmFontListEntryLoad(3X)				      XmFontListEntryLoad(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoonnttLLiissttEEnnttrryyLLooaadd -	A font list function that loads	a font or creates a
  font set and creates an accompanying font list entry

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tEEnnttrryy XXmmFFoonnttLLiissttEEnnttrryyLLooaadd ((_d_i_s_p_l_a_y,	_f_o_n_t__n_a_m_e, _t_y_p_e, _t_a_g))
       DDiissppllaayy	 **_d_i_s_p_l_a_y;;
       cchhaarr	 **_f_o_n_t__n_a_m_e;;
       XXmmFFoonnttTTyyppee_t_y_p_e;;
       cchhaarr	 **_t_a_g;;

DESCRIPTION
  XXmmFFoonnttLLiissttEEnnttrryyLLooaadd loads a font or creates a	font set based on the value
  of the _t_y_p_e argument.	 It creates and	returns	a font list entry that con-
  tains	the font or font set and the specified tag.

  If the value of _t_y_p_e is XXmmFFOONNTT__IISS__FFOONNTT, the function uses the
  XXttCCvvttSSttrriinnggTTooFFoonnttSSttrruucctt routine to convert the value of _f_o_n_t__n_a_m_e to a font
  struct.  If the value	of _t_y_p_e	is XXmmFFOONNTT__IISS__FFOONNTTSSEETT, the function uses	the
  XXttCCvvttSSttrriinnggTTooFFoonnttSSeett converter to create a font set in the current locale.
  XXmmFFoonnttLLiissttEEnnttrryyLLooaadd creates a	font list entry	that contains the font or
  font set derived from	the converter.	For more information about
  XXttCCvvttSSttrriinnggTTooFFoonnttSSttrruucctt and XXttCCvvttSSttrriinnggTTooFFoonnttSSeett, see	_X _T_o_o_l_k_i_t
  _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e	_I_n_t_e_r_f_a_c_e.

  _d_i_s_p_l_a_ySpecifies the display where the font list will	be used.

  _f_o_n_t__n_a_m_e
	 Specifies an X	Logical	Font Description (XLFD)	string,	which is
	 interpreted either as a font name or as a base	font name list.	A
	 base font name	list is	a comma-separated and NULL-terminated string.

  _t_y_p_e	 Specifies whether the _f_o_n_t__n_a_m_e argument refers to a font name	or to
	 a base	font name list.	 Valid values are XXmmFFOONNTT__IISS__FFOONNTT and
	 XXmmFFOONNTT__IISS__FFOONNTTSSEETT.

  _t_a_g	 Specifies the tag of the font list entry to be	created.  The tag may
	 be specified as XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG.  XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG is
	 used to identify the default font list	element	in a font list when
	 specified as part of a	resource.

RETURN VALUE
  If the specified font	is not found, or the specified font set	can not	be
  created, returns NULL; otherwise, returns a font list	entry.

RELATED	INFORMATION
  XXmmFFoonnttLLiisstt((33XX)), 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)), XXmmFFoonnttLLiissttEEnnttrryyCCrreeaattee((33XX)),
  XXmmFFoonnttLLiissttEEnnttrryyFFrreeee((33XX)), XXmmFFoonnttLLiissttEEnnttrryyGGeettFFoonntt((33XX)),
  XXmmFFoonnttLLiissttEEnnttrryyGGeettTTaagg((33XX)), and XXmmFFoonnttLLiissttRReemmoovveeEEnnttrryy((33XX)).






