DwtFetchIconLiteral(3Dwt) DwtFetchIconLiteral(3Dwt)
Name
DwtFetchIconLiteral - Fetches a named icon literal from a hierarchy.
Syntax
#include <X11/DwtAppl.h>
int DwtFetchIconLiteral(hierarchy_id, index, screen,
display, fgpix, bgpix, pixmap_return)
DRMHierarchy hierarchy_id;
String index;
Screen *screen;
Display *display;
Pixel fgpix;
Pixel bgpix;
Pixmap *pixmap_return;
Arguments
hierarchy_id
Specifies the ID of the UID hierarchy that contains the specified icon literal. The hierarchy_id was returned in a previous call
to DwtOpenHierarchy.
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 struc-
tures 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 XOpenDisplay.
fgpix Specifies the foreground color for the pixmap.
bgpix Specifies the background color for the pixmap.
pixmap_return
Returns the resulting X pixmap value.
Description
The DwtFetchIconLiteral function fetches a named icon literal from a DRM hierarchy, and converts the icon literal to an X pixmap.
Return Values
This function returns one of these status return constants:
DRMSuccess The function executed
successfully.
DRMNotFound The icon literal was not
found in the hierarchy.
DRMFailure The function failed.
See Also
DwtFetchLiteral(3Dwt), DwtFetchColorLiteral(3Dwt)
DwtFetchIconLiteral(3Dwt)
