uilabel
Create label component
Description
lbl = uilabel'Label') in a new figure window and returns the
Label object. MATLAB® calls the uifigure function to create the
figure.
lbl = uilabel(___,Name,Value)Name,Value pair
arguments. Use this option with any of the input argument combinations in the
previous syntaxes.
Examples
Create Label Component with Default Text
fig = uifigure; lbl = uilabel(fig);
Create Label Component in Panel
Specify a Panel as the
parent.
fig = uifigure; pnl = uipanel(fig); lbl = uilabel(pnl);
Set and Access Label Component Properties
Create a default label.
fig = uifigure; lbl = uilabel(fig);
Change the label text and font size.
lbl.Text = 'Result';
lbl.FontSize = 14;
The label is clipped because the current label size is too small for the new text at the new font size.
Determine the current label size by getting the third and fourth elements
of the Position property value.
size = lbl.Position(3:4)
size =
31 15Change the label size to accommodate the new text.
lbl.Position(3:4) = [62 22];
Wrap Long Label Text
Wrap label text to fit within the width of a label.
Create a label. Specify the label text and size.
fig = uifigure;
lbl = uilabel(fig);
lbl.Text = 'The data shown represents 18 months of observations.';
lbl.Position = [500 500 100 60];
Wrap the text in the label.
lbl.WordWrap = 'on';
Input Arguments
parent — Parent container
Figure object (default) | Panel object | Tab object | ButtonGroup object | GridLayout object
Parent container, specified as a Figure object created using
the uifigure function, or one of its child
containers: Tab, Panel, ButtonGroup, or GridLayout. If you do not specify a parent container,
MATLAB calls the uifigure function to create a new Figure object that serves as the parent container.
Name-Value Pair Arguments
Specify optional
comma-separated pairs of Name,Value arguments. Name is
the argument name and Value is the corresponding value.
Name must appear inside quotes. You can specify several name and value
pair arguments in any order as
Name1,Value1,...,NameN,ValueN.
'Text','Sum:' specifies the label displays the text
Sum:.The properties listed here are a subset of the available properties. For the full list, see Label Properties.
Label text, specified as a character vector, cell array of character vectors, string scalar, string array, or 1-D categorical array. Use a cell array of character vectors or a string array to specify multiple lines of text.
Alternatively, use the sprintf function
to create formatted text containing line breaks and other special
characters.
text = sprintf('%s\n%s','Line 1','Line 2'); label = uilabel('Text',text,'Position',[100 100 100 32]);
If you specify text as a character vector without using sprintf,
MATLAB will not interpret control sequences such as \n.
If you specify this property as a categorical array, MATLAB uses the values in the array, not the full set of categories.
Example: 'Threshold'
Example: {'Threshold' 'Value'}
'WordWrap' — Word wrapping to fit component width
'off' (default) | on/off logical value
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.
'off'— Text does not wrap.'on'— Breaks text into new lines so that each line fits within the width of the component and avoids breaking words when possible.
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.