NAME

XmtLayoutPixmap - an XmtLayout gadget that displays a pixmap or a bitmap.

SYNOPSIS

Include File:

#include <Xmt/LayoutG.h>

Constructor:

XmtCreateLayoutPixmap()

Class Name:

XmtLayoutPixmap

Class Pointer:

xmtLayoutPixmapGadgetClass

Class Hierarchy:

RectObj → XmtLayoutGadget → XmtLayoutPixmap

DESCRIPTION

The XmtLayoutPixmap widget is a gadget that displays a bitmap or a pixmap within the XmtLayout widget. Because it is specially implemented for this purpose, it is significantly cheaper than using an XmLabel or XmLabelGadget for this purpose. For bitmaps, any foreground and back ground colors may be specified.

RESOURCES

The LayoutPixmap widget inherits the resources of the RectObj and XmtLayoutGadget classes, and defines the following new resources:

XmtNbackground

The background color to be used to draw XmtNbitmap. If unspecified, the background color the parent Layout widget is used.

XmtNbitmap

A bitmap to be displayed with the specified XmtNbackground and XmtNbackground colors. If XmtNpixmap is also specified, then XmtNbitmap will be ignored.

XmtNbitmask

A single-plane bitmask that defines the shape of the bitmap or pixmap to display. If this resource is specified, it is used as a stipple to display a nonrectangular the bitmap or pixmap.

XmtNforeground

The foreground color to be used to draw XmtNbitmap. If unspecified, the foreground color the parent Layout widget is used.

XmtNpixmap

A multi-plane pixmap with a depth equal to the depth of the Layout widget. If this resource is specified, it overrides any value specified for the XmtNbitmap resource. Since pixmaps have colors encoded directly into them, the pixmap specified with this resource is drawn without using XmtNforeground or XmtNbackground.

SEE ALSO

Chapter 19, The Layout Widget: The Details, XmtCreateLayoutPixmap(), XmtLayout, XmtLayoutBox, XmtLayoutSeparator, XmtLayoutSpace, XmtLayoutString.