# Label

## Examples

![](/files/-M3vetOoMEtP2sg2SqB4)

This is the simplest example for label. 

```java
package com.totalcross;
import totalcross.sys.Settings;
import totalcross.ui.Label;
import totalcross.ui.MainWindow;

public class LabelSample extends MainWindow  {
    public LabelSample(){
        setUIStyle(Settings.MATERIAL_UI);
        Settings.uiAdjustmentsBasedOnFontHeight= true;
    }

    public void initUI(){
        Label helloWord = new Label("Hello World!");
        //helloWord.setText("text");
        add(helloWord, CENTER, CENTER);
        }
}
```

## Label shape

![](/files/-M3vf7IKgYJr4KzT6Pyt)

Modify the shape of the component.

```java
package com.totalcross;
import totalcross.sys.Settings;
import totalcross.ui.Label;
import totalcross.ui.MainWindow;
import totalcross.ui.gfx.Color;
public class LabelSample extends MainWindow{

    public LabelSample(){
        setUIStyle(Settings.MATERIAL_UI);
        Settings.uiAdjustmentsBasedOnFontHeight =  true;
    }

    public void initUI(){
        Label lb1, lb2, lb3, lb4;
        lb1 = new Label("This is a Simple Label", CENTER);
        lb1.setBackForeColors(Color.BLUE,  Color.WHITE);
        add(lb1, CENTER, CENTER, PARENTSIZE +  70, PREFERRED +  20);

        lb2 = new Label("This is a 3D Label", CENTER);
        lb2.setBackForeColors(Color.BLUE,  Color.WHITE);
        lb2.set3d(true);
        add(lb2, CENTER, AFTER +  20, SAME, SAME);

        lb3 = new Label("This is a Inverted Label", CENTER);
        lb3.setBackForeColors(Color.BLUE,  Color.WHITE);
        lb3.setInvert(true);
        add(lb3, CENTER, AFTER +  20, SAME, SAME);

        lb4 = new Label("This is a Label with a large text and line break", CENTER);
        lb4.setBackForeColors(Color.BLUE,  Color.WHITE);
        lb4.autoSplit = true;
        add(lb4, CENTER, AFTER +  20, SAME, 50);

    }

}
```

## Behind the Class

### Attributes

| Type        | Name      | Description                                                                                 |
| ----------- | --------- | ------------------------------------------------------------------------------------------- |
| **int**     | Align     | Sets the text align as LEFT, RIGHT, CENTER and FILL(justified)                              |
| **boolean** | autoSplit | Set to true to let the label split its text based on the width every time its width changes |

### Methods

| Type            | Name                          | Description                                                                                                                                                          |
| --------------- | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Constructor** | Label( )                      | Creates an empty label, using FILL as the preferred width                                                                                                            |
| **Constructor** | Label(String text)            | Creates a label displaying the given text (that may be changed at runtime) using left alignment. Supports inverted text, multiple lines and is scrollable by default |
| **Constructor** | Label(String text, int align) | Like the above, but you can also set the horizontal alignment using one of the constants LEFT, CENTER, RIGHT, or FILL (justified)                                    |
| **void**        | setInvert( )                  | Inverts the back and fore colors                                                                                                                                     |
| **void**        | setHighlighted( )             | Highlights the text by painting the text in all directions with a brighter color, then centered, with the foreground color.                                          |
| **void**        | setHighlightedColor( )        | Sets the color used when highlighting is on                                                                                                                          |
| **void**        | set3d(boolean on)             | Draws the label with a 3d effect                                                                                                                                     |

### **References**

* See the [Label Java Docs ](https://rs.totalcross.com/doc/totalcross/ui/Label.html)for more information.
* See the [Video tutorial](https://www.youtube.com/watch?v=2YiR19jInps) 


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.totalcross.com/documentation/components/label.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.