Control label appearance - MATLAB (2024)

Label text interpreter, specified as:

TeX Markup

Use TeX markup to add superscripts and subscripts and to include special characters in the text.

Modifiers remain in effect until the end of the text. Superscripts and subscripts are an exception because they modify only the next character or the characters within the curly braces. When you set the interpreter to 'tex', the supported modifiers are as follows.

This table lists the supported special characters for the 'tex' interpreter.

LaTeX Markup

To use LaTeX markup, set the interpreter to 'latex'. Use LaTeX markup to format and display mathematical expressions, equations, and special characters. Use dollar symbols around the marked up text. For example, use '$\int_1^{20} x^2 dx$' for inline mode or '$$\int_1^{20} x^2 dx$$' for display mode.

The displayed text uses the default LaTeX font style. The FontName, FontWeight, and FontAngle label properties do not have an effect. To change the font style, use LaTeX markup.

MATLAB supports most standard LaTeX math mode commands. For more information, see Supported LaTeX Commands.

HTML Markup

To use HTML markup, set the interpreter to 'html'. Setting font styles via HTML overrides any equivalent Label font properties. For example, the following code results in red text.

lbl = uilabel('Interpreter','html');lbl.Text = '<p style="color: red;">Text</p>';lbl.FontColor = 'blue';

The interpreter supports a subset of HTML markup. As a general guideline, the interpreter supports text-related tags and styles. Unsupported tags and styles are ignored.

This table lists the supported elements and element attributes.

For more information about these elements, see https://developer.mozilla.org/en-US/docs/Web/HTML/Element.

To use HTML markup to create a hyperlink that runs MATLAB code, see Create Hyperlinks that Run Functions.

You can use HTML style attributes to format HTML content. A style attribute is a string of CSS attributes and their values.

These CSS attributes are supported:

For more information about these attributes, see https://developer.mozilla.org/en-US/docs/Web/CSS/Reference.

Horizontal alignment of the text, specified as:

Aligning label text is useful when the text spans multiple lines.

Vertical alignment of the text, specified as one of the following:

Aligning label text is useful when the text spans multiple lines.

Word wrapping to fit component width, specified as 'off' or 'on', or as numeric or logical 0 (false) or 1 (true). A value of 'off' is equivalent to false, and 'on' is equivalent to true. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

Use this property to prevent text from getting clipped horizontally when the width of the component is smaller than the text you want to display.

Setting the WordWrap property to 'on' does not prevent text from getting clipped vertically when the height of the component is too small to display all the lines of text.

Background color, specified as an RGB triplet, a hexadecimal color code, or one of the color options listed in the table.

For a custom color, specify an RGB triplet or a hexadecimal color code.

Alternatively, you can specify some common colors by name. This table lists the named color options, the equivalent RGB triplets, and hexadecimal color codes.

Here are the RGB triplets and hexadecimal color codes for the default colors MATLAB uses in many types of plots.

Data Types: double | char

Visual appearance of the label, specified as 'on' or 'off', or as numeric or logical 1 (true) or 0 (false). A value of 'on' is equivalent to true, and 'off' is equivalent to false. Thus, you can use the value of this property as a logical value. The value is stored as an on/off logical value of type matlab.lang.OnOffSwitchState.

This property is read-only.

Outer location and size of label, returned as [left bottom width height]. Position values are relative to the parent container. All measurements are in pixel units. This property value is identical to Position.

Layout options, specified as a GridLayoutOptions object. This property specifies options for components that are children of grid layout containers. If the component is not a child of a grid layout container (for example, it is a child of a figure or panel), then this property is empty and has no effect. However, if the component is a child of a grid layout container, you can place the component in the desired row and column of the grid by setting the Row and Column properties on the GridLayoutOptions object.

For example, this code places a label in the third row and second column of its parent grid.

g = uigridlayout([4 3]);tlabel = uilabel(g);tlabel.Layout.Row = 3;tlabel.Layout.Column = 2;

To make the label span multiple rows or columns, specify the Row or Column property as a two-element vector. For example, this label spans columns 2 through 3:

tlabel.Layout.Column = [2 3];

This property is read-only.

Type of graphics object, returned as 'uilabel'.