VASSAL Reference Manual

Home > Module > Game Piece Palette > Game Piece > Text Label

Text Label

This trait displays a text label along with a piece.  The text of the label can be fixed or specifyable by a player at game time.

Text:  The starting value for the label text.  By enclosing the text within tags, you can use simple html format to specify various colors, fonts and sizes. 
Example: <html><b>Bold text</b><p>with a line break<p>and <font color=red>different</font> <font color=blue>colors</font></html> will display as:

Bold text
with a line break
and different colors
Name Format:  A Message Format  that specifies how the name of this piece will be reported:   pieceName is the name of the piece excluding the label, label is the value of the label text (including, unfortunately, html tags).  If the label is empty, then the default name of the piece is always used.
Menu Command:  If not blank, gives the text of the corresponding menu item in the piece's right-click menu
Menu key command:  If blank, the text of the label is permanent.  If set, then gives the keyboard command to set the text of the label
Font size:  The text drawn at this size.
Text Color:  The text is drawn using this color.
Background Color:  The text is drawn within a solid rectangle of this color.  Hit Select and then Cancel to use a transparent background.
Vertical Position:  Draw the label with the given offset from the top, bottom, or center of the piece.
Horizontal Position:  Draw the label with the given offset from the left, right, or center of the piece.
Vertical justification:  Whether the top edge, bottom edge, or center of the label will be drawn at the Horizontal Position specified above.
Horizontal justification:  Whether the right edge, left edge, or center of the label will be drawn at the Vertical Position specified above.