Accelerating the pace of engineering and science

# Text Properties

Control text appearance and behavior

Text properties control the appearance and behavior of a text object. By changing property values, you can modify certain aspects of the text.

Starting in R2014b, you can use dot notation to refer to a particular object and property:

h = text(0.5,0.5,'text here');
s = h.FontSize;
h.FontSize = 12;

If you are using an earlier release, use the get and set functions to query and set properties.

## Text

expand all

### String — Text to display'' (default) | character array | cell array | numeric value

Text to display, specified as a character array, cell array, or numeric value.

Example: 'my label'

Example: {'first line','second line'}

Example: 123

To include numeric variables with text, use the num2str function. For example:

x = 42;
str = ['The value is',num2str(x)']

To include special characters, such as superscripts, subscripts, Greek letters, or mathematical symbols use TeX markup. For a list of supported markup, see the Interpreter property.

To create multiline text:

• Use a cell array, where each cell contains a line of text, such as {'first line','second line'}.

• Use a character array, where each row contains the same number of characters, such as ['abc'; 'ab '].

• Use sprintf to create a string with a new line character, such as sprintf('first line \n second line'). This property converts strings with new line characters to cell arrays.

 Note:   The words default, factory, and remove are reserved words that will not appear in text when quoted as a normal string. To display any of these words individually, precede them with a backslash, such as '\default' or '\remove'.

### Interpreter — Interpretation of text characters'tex' (default) | 'latex' | 'none'

Interpretation of text characters, specified as one of these values:

• 'tex' — Interpret text strings using a subset of TeX markup. This is the default value.

• 'latex' — Interpret text strings using LaTeX markup.

• 'none' — Display literal characters.

#### TeX Markup

By default, MATLAB® supports a subset of TeX markup. Use TeX markup to add superscripts and subscripts, modify the text type and color, and include special characters in the text string.

This table lists the supported modifiers when the Interpreter property is set to 'tex'. Modifiers remain in effect until the end of the string, except for superscripts and subscripts, which only modify the next character or the text within the curly braces {}.

ModifierDescriptionExample of String
^{ }Superscript'text^{superscript}'
_{ }Subscript'text_{subscript}'
\bfBold font'\bf text'
\itItalic font'\it text'
\slOblique font (usually the same as italic font)'\sl text'
\rmNormal font'\rm text'
\fontname{specifier}Font name — Set specifier as the name of a font family. You can use this in combination with other modifiers.'\fontname{Courier} text'
\fontsize{specifier}Font size — Set specifier as a numeric scalar value to change the font size.'\fontsize{15} text'
\color{specifier}Font color — Set specifer as one of these colors: red, green, yellow, magenta, blue, black, white, gray, darkGreen, orange, or lightBlue.'\color{magenta} text'
\color[rgb]{specifier}Custom font color — Set specifier as a three-element RGB triplet.'\color[rgb]{0,0.5,0.5} text'

This table lists the supported special characters when the interpreter is set to 'tex'.

Character SequenceSymbolCharacter SequenceSymbolCharacter SequenceSymbol

\alpha

α

\upsilon

υ

\sim

~

\angle

\phi

Φ

\leq

\ast

*

\chi

χ

\infty

\beta

β

\psi

ψ

\clubsuit

\gamma

γ

\omega

ω

\diamondsuit

\delta

δ

\Gamma

Γ

\heartsuit

\epsilon

ɛ

\Delta

Δ

\zeta

ζ

\Theta

Θ

\leftrightarrow

\eta

η

\Lambda

Λ

\leftarrow

\theta

Θ

\Xi

Ξ

\Leftarrow

\vartheta

ϑ

\Pi

Π

\uparrow

\iota

ι

\Sigma

Σ

\rightarrow

\kappa

κ

\Upsilon

ϒ

\Rightarrow

\lambda

λ

\Phi

Φ

\downarrow

\mu

µ

\Psi

Ψ

\circ

º

\nu

ν

\Omega

Ω

\pm

±

\xi

ξ

\forall

\geq

\pi

π

\exists

\propto

\rho

ρ

\ni

\partial

\sigma

σ

\cong

\bullet

\varsigma

ς

\approx

\div

÷

\tau

τ

\Re

\neq

\equiv

\oplus

\aleph

\Im

\cup

\wp

\otimes

\subseteq

\oslash

\cap

\in

\supseteq

\supset

\lceil

\subset

\int

\cdot

·

\o

ο

\rfloor

\neg

¬

\nabla

\lfloor

\times

x

\ldots

...

\perp

\surd

\prime

´

\wedge

\varpi

ϖ

\0

\rceil

\rangle

\mid

|

\vee

\langle

#### LaTeX Markup

To use LaTeX markup, set the Interpreter property to 'latex'. The displayed text uses the default LaTeX font style. The FontName, FontWeight, and FontAngle properties do not have an effect. To change the font style, use LaTeX markup within the text string.

The maximum size of the string that you can use with the LaTeX interpreter is 1200 characters. For multiline strings, this reduces by about 10 characters per line.

## Font Style

expand all

### Color — Text color[0 0 0] (default) | RGB triplet | color string | 'none'

Text color, specified as a three-element RGB triplet, a color string, or 'none'. The default color is black with an RGB triplet value of [0 0 0]. If you set the color to 'none', then the text is invisible.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7]. This table lists RGB triplet values that have equivalent color strings.

Long NameShort NameRGB Triplet
'yellow''y'[1 1 0]
'magenta''m'[1 0 1]
'cyan''c'[0 1 1]
'red''r'[1 0 0]
'green''g'[0 1 0]
'blue''b'[0 0 1]
'white''w'[1 1 1]
'black'k'[0 0 0]

Example: 'blue'

Example: [0 0 1]

### FontName — Font name'Helvetica' (default) | 'FixedWidth' | system supported font name

Font name, specified as the name of the font to use or the string 'FixedWidth'. To display and print properly, the font name must be a font that your system supports.

To use a fixed-width font that looks good in any locale, use the case-sensitive string 'FixedWidth'. This eliminates the need to hard-code the name of a fixed-width font, which might not display text properly on systems that do not use ASCII character encoding. The 'FixedWidth' value relies on the root FixedWidthFontName property. Setting the root FixedWidthFontName property causes an immediate update of the display to use the new font.

Example: 'Cambria'

### FontSize — Font size10 (default) | scalar value greater than zero

Font size, specified as a scalar value greater than zero in point units. One point equals 1/72 inch. To change the font units, use the FontUnits property.

Example: 12

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

### FontUnits — Font size units'points' (default) | 'inches' | 'centimeters' | 'normalized' | 'pixels'

Font size units, specified as one of the values in this table.

UnitsDescription
'points'1 point equals 1/72 inch.
'inches'Inches
'centimeters'Centimeters
'normalized'Font size is interpreted as a fraction of the axes height. If you resize the axes, MATLAB modifies the font size accordingly.
'pixels'Pixel size depends on the screen resolution.

This property affects the FontSize property. If you set both the FontSize and the FontUnits property in the same function call, then you must set the FontUnits property first for MATLAB to interpret the specified FontSize correctly.

### FontAngle — Character slant'normal' (default) | 'italic'

Character slant, specified as 'normal' or 'italic'. Not all fonts have both font styles. Therefore, the italic font might look the same as the normal font.

 Note:   The 'oblique' value has been removed. Use 'italic' instead.

### FontWeight — Thickness of text characters'normal' (default) | 'bold'

Thickness of the text characters, specified as one of these values:

• 'normal' — Default weight as defined by the particular font

• 'bold' — Thicker characters outlines than normal

MATLAB uses the FontWeight property to select a font from those available on your system. Not all fonts have a bold font weight. Therefore, specifying a bold font weight could still result in the normal font weight.

 Note:   The 'light' and 'demi' font weight values have been removed. Use 'normal' instead.

### FontSmoothing — Smooth font character appearance'on' (default) | 'off'

Smooth font character appearance, specified as one of these values:

• 'on' — Apply font smoothing. Reduce the appearance of jaggedness in the text characters to make the text easier to read.

• 'off' — Do not apply font smoothing.

## Text Box

expand all

### EdgeColor — Color of box outline'none' (default) | RGB triplet | color string

Color of box outline, specified as 'none', a three-element RGB triplet, or a color string. The default edge color of 'none' makes the box outline invisible.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7]. This table lists RGB triplet values that have equivalent color strings.

Long NameShort NameRGB Triplet
'yellow''y'[1 1 0]
'magenta''m'[1 0 1]
'cyan''c'[0 1 1]
'red''r'[1 0 0]
'green''g'[0 1 0]
'blue''b'[0 0 1]
'white''w'[1 1 1]
'black'k'[0 0 0]

Example: 'blue'

Example: [0 0 1]

### BackgroundColor — Color of text box background'none' (default) | RGB triplet | color string

Color of text box background, specified as 'none', a three-element RGB triplet, or a color string. The default background color of 'none' makes the text box background transparent.

An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the color. The intensities must be in the range [0,1], for example, [0.4 0.6 0.7]. This table lists RGB triplet values that have equivalent color strings.

Long NameShort NameRGB Triplet
'yellow''y'[1 1 0]
'magenta''m'[1 0 1]
'cyan''c'[0 1 1]
'red''r'[1 0 0]
'green''g'[0 1 0]
'blue''b'[0 0 1]
'white''w'[1 1 1]
'black'k'[0 0 0]

Example: 'blue'

Example: [0 0 1]

### Margin — Space around text within the text box3 (default) | scalar numeric value

The space around the text within the text box, specified as scalar numeric value in point units.

MATLAB uses the Extent property value plus the Margin property value to determine the size of the text box.

Example: 8

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

### LineStyle — Line style of box outline'-' (default) | '--' | ':' | '-.' | 'none'

Line style of box outline, specified as one of the strings in this table.

StringLine StyleResulting Line
'-'Solid line

'--'Dashed line

':'Dotted line

'-.'Dash-dotted line

'none'Line is invisible

### LineWidth — Width of box outline0.5 (default) | scalar numeric value

Width of box outline, specified as a scalar numeric value in point units. One point equals 1/72 inch.

Example: 1.5

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

## Location and Size

expand all

### Position — Location of text[0 0 0] (default) | two-element vector of form [x y] | three-element vector of form [x y z]

Location of the text, specified as a two-element vector of the form [x y] or a three-element vector of the form [x y z]. If you omit the third element, z, then MATLAB sets it to 0.

By default, the position value is defined in data units. To change the units, use the Units property.

Example: [0.5 0.5 0]

### Extent — Size and location of rectangle that encloses text stringfour-element vector

Size and location of the rectangle that encloses the text string, not including the margin, returned as a four-element vector of the form [left bottom width height]. The first two elements, left and bottom, define the position of the lower left corner of the rectangle. The last two elements, width and height, define the dimensions of the rectangle.

By default, the extent value is defined in data units. To change the units, use the Units property.

Example: [0.5 0.5 0.4 0.2]

### Units — Position and extent units'data' (default) | 'normalized' | 'inches' | 'centimeters' | 'characters' | 'points' | 'pixels'

Position units, specified as one of the values in this table.

UnitsDescription
'data' (default)Data coordinates.
'normalized'Normalized with respect to the axes. The lower left corner of the axes maps to (0,0) and the upper-right corner maps to (1,1).
'inches'Inches.
'centimeters'Centimeters.
'characters'Based on the size of characters in the default system font. The width of one character unit is the width of the letter x. The height of one character unit is the distance between the baselines of two lines of text.
'points'Points. One point equals 1/72 inch.
'pixels'Pixels. Pixel size depends on the screen resolution.

All units, except for 'data', are measured from the lower left corner of the axes. This property affects the Position and Extent properties.

If you specify the Position and Units properties as Name,Value pairs when creating the text object, then the order of specification matters. If you want to define the position with particular units, then you must set the Units property before the Position property.

### Rotation — Text orientation0 (default) | scalar value in degrees

Text orientation, specified as a scalar value in degrees. The default rotation of 0 degrees makes the text horizontal. For vertical text, set this property to 90 or -90. Positive values rotate the text counterclockwise. Negative values rotate the text clockwise.

Example: 90

Example: -90

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

### HorizontalAlignment — Horizontal alignment of text with respect to position point'left' (default) | 'center' | 'right'

Horizontal alignment of the text with respect to the x value in the Position property, specified as one of the values in this table. The vertical line indicates where the x value lies in relation to the text.

ValueResult
'left' (default)

'center'

'right'

### VerticalAlignment — Vertical alignment of text with respect to position point'middle' (default) | 'top' | 'bottom' | 'baseline' | 'cap'

Vertical alignment of the text with respect to the y value in the Position property, specified as one of the values in this table. The horizontal line indicates where the y value lies in relation to the text.

ValueResult
'middle'

'top'

'cap'

'bottom'

'baseline'

## Visibility

expand all

### Visible — Visibility of text'on' (default) | 'off'

Visibility of text, specified as one of these values:

• 'on' — Display the text.

• 'off' — Hide the text without deleting it. You still can access the properties of an invisible text object.

### Clipping — Clipping of text to axes plot box'off' (default) | 'on'

Clipping of the text to the axes plot box, which is the box defined by the axis limits, specified as one of these values:

• 'off' — Do not clip the text. Portions of it might appear outside the axes plot box.

• 'on' — Clips the text to the axes plot box.

• If the axes ClippingStyle property is set to '3dbox', which is the default, then MATLAB either displays the entire text or none of the text, depending on the text position. If the point defined by the text Position property lies inside the axes, then MATLAB displays the entire text. If the point lies outside the axes, then MATLAB displays none of it.

• If the axes ClippingStyle property is set to 'rectangle', then MATLAB displays portions of the text lying inside the axes plot box and does not display portions of the text lying outside the axes plot box.

 Note:   If the Clipping property of the associated axes is set to 'on', which is the default, then each individual object controls its own clipping behavior. If the Clipping property of the axes is set to 'off', then MATLAB does not clip any objects in the axes, regardless of the Clipping property of the individual object.

### EraseMode — (removed) Technique to draw and erase objects'normal' (default) | 'none' | 'xor' | 'background'

 Note:   EraseMode has been removed. You can delete code that accesses the EraseMode property with minimal impact. If you were using EraseMode to create line animations, use the animatedline function instead.

Technique to draw and erase objects, specified as one of these values:

• 'normal' — Redraw the affected region of the display, performing the three-dimensional analysis necessary to correctly render all objects. This mode produces the most accurate picture, but is the slowest. The other modes are faster, but do not perform a complete redraw and, therefore, are less accurate.

• 'none' — Do not erase the object when it is moved or destroyed. After you erase the object with EraseMode,'none', it is still visible on the screen. However, you cannot print the object because MATLAB does not store any information on its former location.

• 'xor' — Draw and erase the object by performing an exclusive OR (XOR) with the color of the screen beneath it. This mode does not damage the color of the objects beneath it. However, the object color depends on the color of whatever is beneath it on the display.

• 'background' — Erase the object by redrawing it in the axes background color, or the figure background color if the axes Color property is 'none'. This damages objects that are behind the erased object, but properly colors the erased object.

MATLAB always prints figures as if the EraseMode property of all objects is set to 'normal'. This means graphics objects created with EraseMode set to 'none', 'xor', or 'background' can look different on screen than on paper. On screen, MATLAB mathematically combines layers of colors and ignores three-dimensional sorting to obtain greater rendering speed. However, MATLAB does not apply these techniques to the printed output. Use the getframe command or other screen capture applications to create an image of a figure containing nonnormal mode objects.

## Identifiers

expand all

### Type — Type of graphics object'text'

Type of graphics object, returned as 'text'. Use this property to find all objects of a given type within a plotting hierarchy, for example, searching for the type using findobj.

### Tag — Tag to associate with text '' (default) | string

Tag to associate with the text, specified as a string. Tags provide a way to identify graphics objects. Use this property to find all objects with a specific tag within a plotting hierarchy, for example, searching for the tag using findobj.

Example: 'January Data'

### UserData — Data to associate with text[] (default) | scalar, vector, or matrix | cell array | character array | table | structure

Data to associate with the text object, specified as a scalar, vector, matrix, cell array, character array, table, or structure. MATLAB does not use this data.

To associate multiple sets of data or to attach a field name to the data, use the getappdata and setappdata functions.

Example: 1:100

Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | struct | table | cell

### DisplayName — (unused) Legend text description'' (default) | string

 Note:   The behavior of the DisplayName property changed in R2014b, and it is not recommended. Text objects do not use this property since legends do not include text objects. This property might be removed in a future release.

### Annotation — (unused) Legend icon display styleAnnotation object

 Note:   The behavior of the Annotation property changed in R2014b, and it is not recommended. Text objects do not use this property since legends do not include text objects. This property might be removed in a future release.

## Parent/Child

expand all

### Parent — Parent of textaxes object | group object | transform object

Parent of text, specified as an axes, group, or transform object.

### Children — Children of textempty GraphicsPlaceholder array

The text has no children. You cannot set this property.

### HandleVisibility — Visibility of object handle'on' (default) | 'off' | 'callback'

Visibility of object handle in the Children property of the parent, specified as one of these values:

• 'on' — List the text object.

• 'off' — Do not list the text object. Use this option to hide object handles when a callback invokes a function that could damage the GUI, such as evaluating a user-typed string.

• 'callback' — List the text object in the Children property of the parent from within callbacks or functions invoked by callbacks, but not from within functions invoked from the command line. Use this option to protect a GUI from command-line users, while allowing callbacks to have access to objects.

If the text object is not listed in the Children property of the parent, then functions that obtain object handles by searching the object hierarchy or querying handle properties cannot return it. This includes get, findobj, gca, gcf, gco, newplot, cla, clf, and close.

Hidden object handles are still valid. Set the root ShowHiddenHandles property to 'on' to list all object handles regardless of their HandleVisibility property setting.

## Interactive Control

expand all

### Editing — Interactive edit mode'off' (default) | 'on'

Interactive edit mode, specified as one of these values:

• 'off' — Do no allow interactive string editing. To change the text string you must set the String property. This is the default value.

• 'on' — Allow interactive string editing. MATLAB places an insert cursor within the text and typing changes the text. To apply the new text string, do any of the following:

• Press the Esc key.

• Click anywhere away from the text string.

• Reset the Editing property to 'off'.

MATLAB updates the String property to contain the new text and resets the Editing property to 'off'.

### ButtonDownFcn — Mouse-click callback'' (default) | function handle | cell array | string

Mouse-click callback, specified as one of these values:

• Function handle

• Cell array containing a function handle and additional arguments

• String that is a valid MATLAB command or function, which is evaluated in the base workspace (not recommended)

Use this property to execute code when you click the text. If you specify this property using a function handle, then MATLAB passes two arguments to the callback function when executing the callback:

• The text object — You can access properties of the text object from within the callback function.

• Event data — This argument is empty for this property. Replace it with the tilde character (~) in the function definition to indicate that this argument is not used.

For more information on how to use function handles to define callback functions, see Callback Definition.

 Note:   If the PickableParts property is set to 'none' or if the HitTest property is set to 'off', then this callback does not execute.

Example: @myCallback

Example: {@myCallback,arg3}

Context menu, specified as a uicontextmenu object. Use this property to display a context menu when you right-click the text. Create the context menu using the uicontextmenu function.

 Note:   If the PickableParts property is set to 'none' or if the HitTest property is set to 'off', then the context menu does not appear.

### Selected — Selection state'off' (default) | 'on'

Selection state, specified as one of these values:

• 'on' — Selected. If you click the text when in plot edit mode, then MATLAB sets its Selected property to 'on'. If the SelectionHighlight property also is set to 'on', then MATLAB displays selection handles around the text.

• 'off' — Not selected.

### SelectionHighlight — Display of selection handles when selected'on' (default) | 'off'

Display of selection handles when selected, specified as one of these values:

• 'on' — Display selection handles when the Selected property is set to 'on'.

• 'off' — Never display selection handles, even when the Selected property is set to 'on'.

## Callback Execution Control

expand all

### PickableParts — Ability to capture mouse clicks'visible' (default) | 'all' | 'none'

Ability to capture mouse clicks, specified as one of these values:

• 'visible' — Can capture mouse clicks only when visible. The Visible property must be set to 'on'. The HitTest property determines if the text responds to the click or if an ancestor does.

• 'all' — Can capture mouse clicks regardless of visibility. The Visible property can be set to 'on' or 'off'. The HitTest property determines if the text responds to the click or if an ancestor does.

• 'none' — Cannot capture mouse clicks. Clicking the text passes the click to the object below it in the current view of the figure window, which is typically the axes or the figure. The HitTest property has no effect.

If you want an object to be clickable when it is underneath other objects that you do not want to be clickable, then set the PickableParts property of the other objects to 'none' so that the click passes through them.

### HitTest — Response to captured mouse clicks'on' (default) | 'off'

Response to captured mouse clicks, specified as one of these values:

• 'on' — Trigger the ButtonDownFcn callback of the text. If you have defined the UIContextMenu property, then invoke the context menu.

• 'off' — Trigger the callbacks for the nearest ancestor of the text that has a HitTest property set to 'on' and a PickableParts property value that enables the ancestor to capture mouse clicks.

 Note:   The PickableParts property determines if the text object can capture mouse clicks. If it cannot, then the HitTest property has no effect.

### Interruptible — Callback interruption'on' (default) | 'off'

Callback interruption, specified as 'on' or 'off'. The Interruptible property determines if a running callback can be interrupted.

 Note:   There are two callback states to consider:The running callback is the currently executing callback. The interrupting callback is a callback that tries to interrupt the running callback.Whenever MATLAB invokes a callback, that callback attempts to interrupt a running callback. The Interruptible property of the object owning the running callback determines if interruption is allowed. If interruption is not allowed, then the BusyAction property of the object owning the interrupting callback determines if it is discarded or put in the queue.

If the ButtonDownFcn callback of the text is the running callback, then the Interruptible property determines if it another callback can interrupt it:

• 'on' — Interruptible. Interruption occurs at the next point where MATLAB processes the queue, such as when there is a drawnow, figure, getframe, waitfor, or pause command.

• If the running callback contains one of these commands, then MATLAB stops the execution of the callback at this point and executes the interrupting callback. MATLAB resumes executing the running callback when the interrupting callback completes. For more information, see Interrupt Callback Execution.

• If the running callback does not contain one of these commands, then MATLAB finishes executing the callback without interruption.

• 'off' — Not interruptible. MATLAB finishes executing the running callback without any interruptions.

### BusyAction — Callback queuing'queue' (default) | 'cancel'

Callback queuing specified as 'queue' or 'cancel'. The BusyAction property determines how MATLAB handles the execution of interrupting callbacks.

 Note:   There are two callback states to consider:The running callback is the currently executing callback. The interrupting callback is a callback that tries to interrupt the running callback.Whenever MATLAB invokes a callback, that callback attempts to interrupt a running callback. The Interruptible property of the object owning the running callback determines if interruption is allowed. If interruption is not allowed, then the BusyAction property of the object owning the interrupting callback determines if it is discarded or put in the queue.

If the ButtonDownFcn callback of the text tries to interrupt a running callback that cannot be interrupted, then the BusyAction property determines if it is discarded or put in the queue. Specify the BusyAction property as one of these values:

• 'queue' — Put the interrupting callback in a queue to be processed after the running callback finishes execution. This is the default behavior.

• 'cancel' — Discard the interrupting callback.

## Creation and Deletion Control

expand all

### CreateFcn — Creation callback'' (default) | function handle | cell array | string

Creation callback, specified as one of these values:

• Function handle

• Cell array containing a function handle and additional arguments

• String that is a valid MATLAB command or function, which is evaluated in the base workspace (not recommended)

Use this property to execute code when you create the text. Setting the CreateFcn property on an existing text has no effect. You must define a default value for this property, or define this property using a Name,Value pair during text creation. MATLAB executes the callback after creating the text and setting all of its properties.

If you specify this callback using a function handle, then MATLAB passes two arguments to the callback function when executing the callback:

• The text object — You can access properties of the text object from within the callback function. You also can access the text object through the CallbackObject property of the root, which can be queried using the gcbo function.

• Event data — This argument is empty for this property. Replace it with the tilde character (~) in the function definition to indicate that this argument is not used.

For more information on how to use function handles to define callback functions, see Callback Definition.

Example: @myCallback

Example: {@myCallback,arg3}

### DeleteFcn — Deletion callback'' (default) | function handle | cell array | string

Deletion callback, specified as one of these values:

• Function handle

• Cell array containing a function handle and additional arguments

• String that is a valid MATLAB command or function, which is evaluated in the base workspace (not recommended)

Use this property to execute code when you delete the text. MATLAB executes the callback before destroying the text so that the callback can access its property values.

If you specify this callback using a function handle, then MATLAB passes two arguments to the callback function when executing the callback:

• The text object — You can access properties of the text object from within the callback function. You also can access the text object through the CallbackObject property of the root, which can be queried using the gcbo function.

• Event data — This argument is empty for this property. Replace it with the tilde character (~) in the function definition to indicate that this argument is not used.

For more information on how to use function handles to define callback functions, see Callback Definition.

Example: @myCallback

Example: {@myCallback,arg3}