dwtfetchiconliteral(3dwt) [ultrix man page]

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)

MrmFetchBitmapLiteral(library call)									       MrmFetchBitmapLiteral(library call)

NAME

       MrmFetchBitmapLiteral -- Fetches a bitmap literal from a hierarchy

SYNOPSIS

       #include <Mrm/MrmPublic.h>
       Cardinal MrmFetchBitmapLiteral(
       MrmHierarchy hierarchy_id,
       String index,
       Screen *screen,
       Display *display,
       Pixmap *pixmap_return,
       Dimension *width,
       Dimension *height);

DESCRIPTION

       The  MrmFetchBitmapLiteral function fetches a bitmap literal from an MRM hierarchy, and converts the bitmap literal to an X pixmap of depth
       1. The function returns this pixmap and its width and height.

       hierarchy_id
		 Specifies the ID of the UID hierarchy that contains the specified icon literal. The value of hierarchy_id was returned in a  pre-
		 vious call to MrmOpenHierarchyPerDisplay.

       index	 Specifies the UIL name of the bitmap 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.

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

       width	 Specifies a pointer to the width of the pixmap.

       height	 Specifies a pointer to the height of the pixmap.

RETURN

       This function returns one of the following status return constants:

       MrmSUCCESS
		 The function executed successfully.

       MrmBAD_HIERARCHY
		 The hierarchy ID was invalid.

       MrmNOT_FOUND
		 The bitmap literal was not found in the hierarchy.

       MrmWRONG_TYPE
		 The caller tried to fetch a literal of a type not supported by this function.

       MrmFAILURE
		 The function failed.

RELATED

       MrmFetchIconLiteral(3), MrmFetchLiteral(3), and XOpenDisplay(3).

													       MrmFetchBitmapLiteral(library call)