xmfontlistnextentry(3) [centos man page]

XmFontListNextEntry(library call)										 XmFontListNextEntry(library call)

NAME

       XmFontListNextEntry -- A font list function that returns the next entry in a font list

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontListEntry XmFontListNextEntry(
       XmFontContext context);

DESCRIPTION

       XmFontListNextEntry  returns  the  next entry in the font list. The application uses the XmFontListInitFontContext routine to create a font
       list context. The first call to XmFontListNextEntry sets the context to the first entry in  the	font  list.  The  application  then  calls
       XmFontListNextEntry  repeatedly	with  the  same context. Each succeeding call accesses the next entry of the font list. When finished, the
       application calls XmFontListFreeFontContext to free the allocated font list context.

       context	 Specifies the font list context

RETURN

       Returns NULL if the context does not refer to a valid entry or if it is at the end of the font list; otherwise,	it  returns  a	font  list
       entry.	If  the  function does return a font list entry, the font list entry is not a copy. Therefore, the application should not free the
       returned font list entry.

RELATED

       XmFontList(3), XmFontListEntryFree(3), XmFontListEntryGetFont(3), XmFontListEntryGetTag(3),  XmFontListFreeFontContext(3),  and	XmFontLis-
       tInitFontContext(3).

														 XmFontListNextEntry(library call)

XmFontListGetNextFont(library call)									       XmFontListGetNextFont(library call)

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 XmFontLis-
       tInitFontContext 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 finished, the application calls XmFontListFreeFontContext to free the
       allocated font list context.

       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  XmFontListGet-
       NextFont  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(library call)