NAME    [Toc]    [Back]

       MrmFetchIconLiteral - Fetches an icon literal from a hierarchy

SYNOPSIS    [Toc]    [Back]

       #include <Mrm/MrmPublic.h>

       int MrmFetchIconLiteral(hierarchy_id, index, screen,  display,
 fgpix, pixmap)
               MrmHierarchy hierarchy_id;
               String index;
               Screen *screen;
               Display *display;
               Pixel fgpix;
               Pixel bgpix;
               Pixmap *pixmap;

DESCRIPTION    [Toc]    [Back]

       The  MrmFetchIconLiteral  function fetches an icon literal
       from an MRM hierarchy, and converts the icon literal to an
       X pixmap.  Specifies the ID of the UID hierarchy that contains
 the specified icon  literal.  The  hierarchy_id  was
       returned in a previous call to MrmOpenHierarchyPerDisplay.
       Specifies the UIL name  of  the  icon  literal  to  fetch.
       Specifies the screen used for the pixmap. The screen argument
 specifies a pointer  to  the  Xlib  structure  Screen
       which  contains  the  information about that screen and is
       linked to the Display structure. For more  information  on
       the  Display  and Screen structures, see the Xlib function
       XOpenDisplay and the associated screen information macros.
       Specifies  the  display  used  for the pixmap. The display
       argument specifies the connection to  the  X  server.  For
       more  information  on  the Display structure, see the Xlib
       function XOpenDisplay.  Specifies the foreground color for
       the  pixmap.   Specifies  the  background  color  for  the
       pixmap.  Returns the resulting X pixmap value.

RETURN VALUE    [Toc]    [Back]

       This function returns one  of  these  status  return  constants:
 The function executed successfully.  The hierarchy
       ID was invalid.  The icon literal was  not  found  in  the
       hierarchy.   The caller tried to fetch a literal of a type
       not supported by this function.  The function failed.

SEE ALSO    [Toc]    [Back]

       MrmFetchBitmapLiteral(3X), MrmOpenHierarchyPerDisplay(3X),
       MrmFetchLiteral(3X),  MrmFetchColorLiteral(3X),  XOpenDisplay(3X11)




                                          MrmFetchIconLiteral(3X)