A message control is a static line of text or a static bitmap. The
text or bitmap corresponds to the message’s label (see
set-label).
Creates a string or bitmap message initially showing
label.
If
label is a bitmap, and if the
bitmap has a mask (see
get-loaded-mask in
bitmap%)
that is the same size as the bitmap, then the mask is used for the
label. Modifying a bitmap while it is used as a label has
an unspecified effect on the displayed label. An
'app,
'caution, or
'stop symbol for
label indicates an icon;
'app is the application
icon (Windows and Mac OS) or a generic “info” icon (X),
'caution is a caution-sign icon, and
'stop is a
stop-sign icon.
If & occurs in label, it is specially parsed;
under Windows and X, the character
following & is underlined in the displayed control to
indicate a keyboard mnemonic. (Under Mac OS, mnemonic underlines are
not shown.) The mnemonic is meaningless for a message (as far as
on-traverse-char in top-level-window<%> is concerned),
but it is supported for consistency with other control types. A
programmer may assign a meaning to the mnemonic (e.g., by overriding
on-traverse-char).
If style includes 'deleted, then the message is created as hidden,
and it does not affect its parent’s geometry; the message can be made active later by calling
parent’s add-child method.
The font argument determines the font for the control. For information about the enabled argument, see window<%>. For information about the horiz-margin and vert-margin
arguments, see subarea<%>. For information about the
min-width, min-height, stretchable-width, and
stretchable-height arguments, see area<%>.
If auto-resize is not #f, then automatic resizing is
initially enabled (see auto-resize), and the
message% object’s graphical minimum size is as small as
possible.
Otherwise, sets the bitmap label for a bitmap message.
Since
label is a bitmap, if the
bitmap has a mask (see
get-loaded-mask in
bitmap%)
that is the same size as the bitmap, then the mask is used for the
label. Modifying a bitmap while it is used as a label has
an unspecified effect on the displayed label. The bitmap label is installed only
if the control was originally created with a bitmap label.