xmfontlistnextentry(3x) [osf1 man page]

XmFontListNextEntry(3X) 												   XmFontListNextEntry(3X)

NAME

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

SYNOPSIS

       #include <Xm/Xm.h>

       XmFontListEntry XmFontListNextEntry (context)
	       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.  Specifies the font list context

RETURN VALUE

       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.

SEE ALSO

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

															   XmFontListNextEntry(3X)

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)