| 1 | {{Template:GUI_Object|text|[wiki:GUI_-_Properties#buffer_zone buffer_zone], [wiki:GUI_-_Properties#caption caption], [wiki:GUI_-_Properties#cell_id cell_id], [wiki:GUI_-_Properties#font font], [wiki:GUI_-_Properties#scrollbar scrollbar], [wiki:GUI_-_Properties#scrollbar_style scrollbar_style], [wiki:GUI_-_Properties#sprite sprite], [wiki:GUI_-_Properties#text_align text_align], [wiki:GUI_-_Properties#text_valign text_valign], [wiki:GUI_-_Properties#textcolor textcolor], [wiki:GUI_-_Properties#tooltip tooltip], [wiki:GUI_-_Properties#tooltip_style tooltip_style]|none}} |
| 2 | |
| 3 | A text box is used to draw text on top of an optional sprite, if you have no text to draw, then the [wiki:GUI_-_Image Image] control will suffice. |
| 4 | |
| 5 | Notice that when ''scrollbar'' is true, ''text_valign'' is ignored and always considered "top". Along the same lines, ''buffer_zone'' is always ignored if both ''text_align'' and ''text_valign'' is set to "center". |
| 6 | |
| 7 | [wiki:Image:gui-object-text.png] |
| 8 | |
| 9 | To learn more about how to change the font, color, and add icons and images, see [wiki:GUI_-_Text_Renderer Text Renderer]. |
| 10 | |
| 11 | '''''Code of example texts:''''' |
| 12 | |
| 13 | {{{ |
| 14 | <object type="text" |
| 15 | name="the_one_to_the_left" |
| 16 | size="20 20 260 130" |
| 17 | font="verdana12" |
| 18 | sprite="gd-input" |
| 19 | textcolor="0 0 0" |
| 20 | scrollbar="true" |
| 21 | scrollbar_style="gd-scrollbar" |
| 22 | buffer_zone="5" |
| 23 | >Fire is a form of [color="50 70 120"]combustion[/color] ... |
| 24 | </object> |
| 25 | |
| 26 | <object type="text" |
| 27 | name="the_one_to_the_right" |
| 28 | size="300 60 380 110" |
| 29 | text_align="center" |
| 30 | text_valign="center" |
| 31 | font="verdana12" |
| 32 | sprite="gd-input" |
| 33 | textcolor="0 0 0" |
| 34 | scrollbar="false" |
| 35 | >Centered |
| 36 | </object> |
| 37 | }}} |