Man Linux: Main Page and Category List


       MrmFetchIconLiteral — Fetches an icon literal from a hierarchy


       #include <Mrm/MrmPublic.h>
       Cardinal MrmFetchIconLiteral(
       MrmHierarchy hierarchy_id,
       String index,
       Screen *screen,
       Display *display,
       Pixel fgpix,
       Pixel bgpix,
       Pixmap *pixmap);


       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.

       index     Specifies the UIL name of the icon literal to fetch.

       screen    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.

       display   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

       fgpix     Specifies the foreground color for the pixmap.

       bgpix     Specifies the background color for the pixmap.

       pixmap    Returns the resulting X pixmap value.  The function allocates
                 space  for  this  pixmap.  The application is responsible for
                 managing the allocated space.  The  application  can  recover
                 the allocated space by calling XmDestroyPixmap.


       This function returns one of the following 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.


       MrmFetchBitmapLiteral(3),                MrmOpenHierarchyPerDisplay(3),
       MrmFetchLiteral(3), MrmFetchColorLiteral(3), and XOpenDisplay(3).

                                             MrmFetchIconLiteral(library call)