SET(ICONIFY_PIXMAP)

    Determines the pixmap the application uses to create its icon in the
    DECwindows icon box if the user has selected the Small Window Manager
    Icon Style.  When you use SET (ICONFIY_PIXMAP), VAXTPU also
    automatically places the specified pixmap in the application title
    bar's iconify button.

 Syntax

    Choose either of two variants:

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

                        or

    SET (ICONIFY_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 iconify
                         pixmap.  The icon must be declared EXPORTED in the
                         UIL file.

    string2              The file specification of a bitmap file.  SET
                         (ICONIFY_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 iconify pixmap is to be set.  By
                         default, VAXTPU sets the iconify pixmap of its
                         top-level widget.

 Comments

    To specify an iconify 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 (ICONIFY_PIXMAP) so a small icon can be
    displayed, in most cases the application should also use SET
    (ICON_PIXMAP) so a large icon can be displayed if the user selects the
    Large 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 iconify pixmap stored in the file
    ICONIFY_FLAMINGO.X11 to be displayed in the application's iconify
    button and in the application's icon if the small Window Manager Icon
    Style has been selected:

    SET (ICONIFY_PIXMAP, "DISK1:[SMITH]ICONIFY_FLAMINGO.X11")

 Related Topics

       SET(ICON_NAME)    SET(ICON_PIXMAP)