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

  
 
  

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  en-
     try of the font list. The application first uses the XmFontListInitFontCon-
     text routine to create a font list context.  The application then calls Xm-
     FontListGetNextFont  repeatedly with the same context. Each succeeding call
     accesses the next element of the font list. When finished, the  application
     calls XmFontListFreeFontContext to free the allocated font list context.

     NOTE:  This function is obsolete and exists for compatibility with previous
     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 applica-
     tion can recover the allocated memory by calling XtFree.

     This function is obsolete and exists for compatibility  with  previous  re-
     leases. It is replaced by XmFontListNextEntry.  If XmFontListGetNextFont 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 re-
	       turns 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