Man Linux: Main Page and Category List

NAME

       XmFontListCreate — A font list function that creates a font list

SYNOPSIS

       #include <Xm/Xm.h>
       XmFontList XmFontListCreate(
       XFontStruct * font,
       XmStringCharSet charset);

DESCRIPTION

       XmFontListCreate  creates  a  new  font  list  with  a  single  element
       specified by the provided font and character set. It also allocates the
       space for the font list.

       NOTE:  This  function  is  obsolete  and  exists for compatibility with
       previous releases. It is replaced by XmFontListAppendEntry.

       font      Specifies a pointer to a font structure  for  which  the  new
                 font list is generated. This is the structure returned by the
                 XLib XLoadQueryFont function.

       charset   Specifies the character set identifier for  the  font.   This
                 can  be  XmSTRING_DEFAULT_CHARSET,  but  this  value does not
                 comply with the AES, and it may be removed in future versions
                 of  Motif.   If  the  value  is XmSTRING_DEFAULT_CHARSET, the
                 routine derives the character set from the  current  language
                 environment.

RETURN

       Returns  NULL if font or charset is NULL; otherwise, returns a new font
       list.

RELATED

       XmFontList(3) and XmFontListAppendEntry(3).

                                                XmFontListCreate(library call)