The class IlvMessageLabel displays a message, which can be accompanied by a bitmap. Messages are recorded in a database that can be associated with the current instance of IlvDisplay.

The alignment of the message relative to the bitmap can be set to any position. In addition, it is possible to change the alignment of the whole block (message + bitmap) to IlvCenter, IlvLeft, or IlvRight in relation to its bounding box.

A Message Label shows an example of an IlvMessageLabel. The alignment of the message relative to the picture is IlvBottom, and the global alignment of the IlvMessageLabel is IlvCenter.

This section covers the following topics:

Bitmaps can be associated with a message label using the member functions IlvMessageLabel::setBitmap and IlvMessageLabel::setInsensitiveBitmap.

setBitmap associates a main bitmap with the message label. setInsensitiveBitmap sets the bitmap that will be displayed when the message label is set to nonsensitive. If you do not provide a nonsensitive bitmap, a default one is automatically computed from the sensitive bitmap when setting the message label to nonsensitive.

See Localizing a Gadget.

Unlike the other gadgets, the message label is transparent by default. To make it opaque, call the member function setTransparent with IlFalse as its parameter. The bounding box of an opaque message label is filled with the background color that is set in the object palette.

See Setting a Gadget as Transparent.

When a message label displays both a label and a bitmap, you can change the position of the label relative to the bitmap using the member function IlvMessageLabel::setLabelPosition.

For example, to have the label appear to the left of the bitmap, call:

To set the spacing between the label and the bitmap to 20 pixels, call:

To center the grouped label and the bitmap inside the bounding box of the message label, call:

A message label can be localized.

See Localizing a Gadget.

Message labels can include a mnemonic letter. When you press the key corresponding to the mnemonic letter with the modifier key (Alt on PCs or Meta on UNIX), or click the message label, the focus is given to the next gadget in the focus chain.

See Associating a Mnemonic with a Gadget Label.