Textmessage

  (subclass of 9.1.3.15 Item)

A simple static text (though the text can be changed while displayed). Allows to set different alignment modes (see below) and border styles.

If the displayed text -- sometimes called label -- contains n characters it will have multiple lines.

typedef enum {
  afCenter,
  afTop,
  afBottom,
  afLeft,
  afRight
} ALIGN_FLAGS;

   GRAPE(textmessage, "change-border")(border)

TEXTMESSAGE *textmessage
BORDER_FLAG border

Set the border style. A Textmessage will look like a pressed Button if border is set to bfBorder, it will look like simple text if bfNoBorder is used.

   (char * ) GRAPE(textmessage, "get-text")(buf, len)

TEXTMESSAGE *textmessage
char *buf
int len

The caller supplied buffer buf (char[len]) is filled with the currently shown label.

   GRAPE(Textmessage, "new-instance")(lines)

TEXTMESSAGE *textmessage
char *lines

Create a new instance. Name and label are set to be copies of lines.

If the name shall be distinct from the label use StaticText instead.

   GRAPE(textmessage, "set-align")(alignment)

TEXTMESSAGE *textmessage
ALIGN_FLAGS alignment

Set a new text alignment inside the rectangular border. alignment is (vertical alignment) | (horizontal alignment). Example: (afCenter | afRight).

   GRAPE(textmessage, "set-text")(text)

TEXTMESSAGE *textmessage
char *text

Use text as new label, i.e. as message.