plucky (3) XmFontListRemoveEntry.3.gz

Provided by: libmotif-dev_2.3.8-4_amd64 bug

NAME
       XmFontListRemoveEntry  —  A  font  list  function  that  removes  a  font  list  entry  from  a font list
       "XmFontListRemoveEntry" "font list functions" "XmFontListRemoveEntry"


SYNOPSIS
       #include <Xm/Xm.h>
       XmFontList XmFontListRemoveEntry(
       XmFontList oldlist,
       XmFontListEntry entry);


DESCRIPTION
       XmFontListRemoveEntry creates a new font list that contains the contents of oldlist minus  those  entries
       specified  in  entry.   The routine removes any entries from oldlist that match the components (tag, type
       font/font set) of the specified entry. The function deallocates the original font list  after  extracting
       the  required  information.  The  caller  uses  XmFontListEntryFree  to  recover memory allocated for the
       specified entry. This routine does not free the XFontSet or XFontStruct associated  with  the  font  list
       entry that is removed.

       oldlist   Specifies the font list

       entry     Specifies the font list entry to be removed


RETURN
       If  oldlist  is NULL, the function returns NULL. If entry is NULL or no entries are removed, the function
       returns oldlist. Otherwise, it returns a new font list.  If the function returns a  new  font  list,  the
       function  allocates  space  to  hold  the  new font list. The application is responsible for managing the
       allocated space. The application can recover the allocated space by calling XmFontListFree.


       XmFontList(3),      XmFontListAppendEntry(3),      XmFontListEntryCreate(3),      XmFontListEntryFree(3),
       XmFontListEntryLoad(3), and XmFontListFree(3).

                                                                                        XmFontListRemoveEntry(3)