SET(ICON_PIXMAP)

    Determines the pixmap the application uses to create its icon in the
    DECwindows icon box if the user has selected the Large Window Manager
    Icon Style.

 Syntax

    Choose either of two variants:

    SET (ICON_PIXMAP, integer, string1  [,widget])

                        or

    SET (ICON_PIXMAP, string2 [,widget])

 Parameters

    integer              The hierarchy identifier returned by the SET
                         (DRM_HIERARCHY) built-in.  This identifier is
                         passed to the XUI Resource Manager, which uses the
                         identifier to find the hierarchy's resource name
                         in the resource database.

    string1              A case-sensitive string that is the name assigned
                         to the icon in the UIL file defining the icon
                         pixmap.  The icon must be declared EXPORTED in the
                         UIL file.

    string2              The file specification of a bitmap file.  SET
                         (ICON_PIXMAP) requires these files to be in the
                         format created by the Xlib routine WRITE BITMAP
                         FILE.  To create a file with the correct format,
                         you can use the program SYS$SYSTEM:DECW$PAINT.EXE
                         (the DECpaint application) or the program
                         DECW$EXAMPLES:BITMAP.EXE.  If you use DECpaint,
                         use the Customize Picture Size option to set the
                         picture size to non-standard, the width to 32
                         pixels, and the height to 32 pixels.  Use the Zoom
                         option to manipulate this small image.  Choose the
                         X11 format when you save the file.

    widget               The widget whose icon pixmap is to be set.  By
                         default, VAXTPU sets the icon pixmap of its
                         top-level widget.

 Comments

    To specify an icon pixmap defined in a UIL file, use the first syntax
    variant shown in the Syntax section.  To specify an icon created in a
    bitmap file, use the second syntax variant shown in the Syntax section.

    If an application uses SET (ICON_PIXMAP) so a large icon can be
    displayed, in most cases the application should also use SET
    (ICONIFY_PIXMAP) to create an iconify button in the menu bar.  An
    application also needs to use SET (ICONIFY_PIXMAP) so a small icon can
    be displayed if the user selects the Small Window Manager Icon Style.

    Note that the user selects the Large or Small Window Manager Icon Style
    using the Session Manager's Customize Window dialog box.

 Example

    The following statement causes the icon pixmap stored in the file
    ICON_FLAMINGO.X11 to be displayed in the application's icon if the
    Large Window Manager Icon Style has been selected:

    SET (ICON_PIXMAP, "DISK1:[SMITH]ICON_FLAMINGO.X11")

 Related Topics

       SET(ICON_NAME)    SET(ICONIFY_PIXMAP)