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

FreeBSD Manual Pages

  
 
  

home | help
XmFontListGetNextFont(3)   Library Functions Manual   XmFontListGetNextFont(3)

NAME
       XmFontListGetNextFont  -- A font	list function that allows applications
       to access the fonts and character sets in a font	list

SYNOPSIS
       #include	<Xm/Xm.h>
       Boolean XmFontListGetNextFont(
       XmFontContext context,
       XmStringCharSet *charset,
       XFontStruct **font);

DESCRIPTION
       XmFontListGetNextFont accesses the character set	and font for the  next
       entry  of the font list.	The application	first uses the XmFontListInit-
       FontContext routine to create a font  list  context.   The  application
       then calls XmFontListGetNextFont	repeatedly with	the same context. Each
       succeeding  call	 accesses the next element of the font list. When fin-
       ished, the application calls XmFontListFreeFontContext to free the  al-
       located font list context.

       NOTE:  This function is obsolete	and exists for compatibility with pre-
       vious releases. It has been replaced by XmFontListNextEntry.

       This routine allocates memory for the character set string that must be
       freed by	the application.  The function allocates memory	 for  charset.
       The  application	is responsible for managing the	allocated memory.  The
       application can recover the allocated memory by calling XtFree.

       This function is	obsolete and exists for	 compatibility	with  previous
       releases. It is replaced	by XmFontListNextEntry.	 If XmFontListGetNext-
       Font 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.

       context	 Specifies the font list context

       charset	 Specifies  a  pointer	to a character set string; the routine
		 returns the character set for the current font	list element

       font	 Specifies a pointer to	a pointer to  a	 font  structure;  the
		 routine returns the font for the current font list element

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

RELATED
       XmFontList(3) and XmFontListNextEntry(3).

						      XmFontListGetNextFont(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmFontListGetNextFont&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help