text properties
text graphics object properties.
📄Description

This page documents the visible properties returned by properties for a text graphics object.

Property Action Type and supported values
AffectAutoLimits recomputes geometry, limits, or layout. Type: finite numeric vector. Supported values: two finite increasing values [min max].
BackgroundColor updates rendered output on the next graphics refresh. Type: color value. Supported values: 'red'/'r', 'green'/'g', 'blue'/'b', 'cyan'/'c', 'magenta'/'m', 'yellow'/'y', 'black'/'k', 'white'/'w', RGB triplet [r g b] with values in [0,1], or hexadecimal color '#RRGGBB'/'#RGB'.
BeingDeleted Nelson computes this value; graphics operations update it. Type: text scalar or character row vector. Supported values: 'off', 'on'.
BusyAction controls whether an interrupting callback is queued or canceled. Type: text scalar or character row vector. Supported values: 'queue', 'cancel'.
ButtonDownFcn runs when the object receives a mouse-button event. Type: callback value. Supported values: [], function handle, character vector, string scalar, or callback cell array.
Children parenting operations update the vector. Type: graphics object handle vector. Supported values: empty vector or child handles.
Clipping updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'on', 'off'.
Color updates rendered output on the next graphics refresh. Type: color value. Supported values: 'red'/'r', 'green'/'g', 'blue'/'b', 'cyan'/'c', 'magenta'/'m', 'yellow'/'y', 'black'/'k', 'white'/'w', RGB triplet [r g b] with values in [0,1], or hexadecimal color '#RRGGBB'/'#RGB'.
ColorMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
ContextMenu attaches the menu used for context-click actions. Type: graphics object handle scalar. Supported values: [] or a uicontextmenu handle.
CreateFcn runs when the object is created. Type: callback value. Supported values: [], function handle, character vector, string scalar, or callback cell array.
DeleteFcn runs when the object is deleted. Type: callback value. Supported values: [], function handle, character vector, string scalar, or callback cell array.
EdgeColor updates rendered output on the next graphics refresh. Type: color value or color mode keyword. Supported values: 'red'/'r', 'green'/'g', 'blue'/'b', 'cyan'/'c', 'magenta'/'m', 'yellow'/'y', 'black'/'k', 'white'/'w', RGB triplet [r g b] with values in [0,1], or hexadecimal color '#RRGGBB'/'#RGB', 'none', 'flat', 'interp'.
Editing updates rendered output on the next graphics refresh. Type: on/off value. Supported values: 'on', 'off', true, or false.
Extent recomputes geometry, limits, or layout. Type: finite numeric vector. Supported values: finite vector with the documented size, such as [left bottom width height], [x y z], [azimuth elevation], or [minor major].
FontAngle updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'normal', 'italic'.
FontName updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: a system font name or 'FixedWidth'.
FontSize recomputes geometry, limits, or layout. Type: finite numeric scalar. Supported values: finite scalar value.
FontSmoothing updates rendered output on the next graphics refresh. Type: on/off value. Supported values: 'on', 'off', true, or false.
FontUnits recomputes geometry, limits, or layout. Type: text scalar or character row vector. Supported values: 'pixels', 'normalized', 'inches', 'centimeters', 'points', 'characters', 'data'.
FontWeight updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'normal', 'bold'.
HandleVisibility controls whether handle-search functions can find the object. Type: text scalar or character row vector. Supported values: 'on', 'off', 'callback'.
HitTest includes or excludes the object from mouse hit testing. Type: text scalar or character row vector. Supported values: 'on', 'off'.
HorizontalAlignment updates rendered output on the next graphics refresh. Type: on/off value. Supported values: 'on', 'off', true, or false.
Interactions updates the stored object state. Type: interaction object, structure, cell array, or empty array. Supported values: [] or interaction definitions for axes and charts.
Interpreter updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'tex', 'latex', 'none'. 'latex' currently falls back to the 'tex' pipeline (a full LaTeX math layout engine is not yet implemented).
Interruptible controls whether a running callback can be interrupted. Type: text scalar or character row vector. Supported values: 'on', 'off'.
LineStyle updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: '-', '--', ':', '-.', 'none'.
LineWidth updates rendered output on the next graphics refresh. Type: finite numeric scalar. Supported values: value greater than or equal to 0.
Margin recomputes geometry, limits, or layout. Type: finite numeric scalar. Supported values: finite scalar value.
Parent reparents the object and updates Children on the old and new parents. Type: graphics object handle scalar. Supported values: a valid parent handle for the object class.
PickableParts selects which visible or invisible parts can receive mouse hits. Type: text scalar or character row vector. Supported values: 'visible', 'all', 'none'.
Position recomputes geometry, limits, or layout. Type: finite numeric vector. Supported values: finite vector with the documented size, such as [left bottom width height], [x y z], [azimuth elevation], or [minor major].
Rotation recomputes geometry, limits, or layout. Type: finite numeric scalar. Supported values: finite scalar value.
Selected updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'on', 'off'.
SelectionHighlight updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'on', 'off'.
SeriesIndex updates the stored object state. Type: integer scalar or numeric vector. Supported values: finite integer value, finite numeric value, or vector required by the property.
String updates displayed text content. Type: text value. Supported values: character row vector, string scalar, string array, or cell array of character row vectors.
Tag updates the stored object state. Type: text scalar or character row vector. Supported values: empty text or an object identifier.
Type Nelson computes this value; graphics operations update it. Type: text scalar or character row vector. Supported values: read-only object type name, for example 'figure', 'axes', 'line', or 'scatter'.
Units recomputes geometry, limits, or layout. Type: text scalar or character row vector. Supported values: 'pixels', 'normalized', 'inches', 'centimeters', 'points', 'characters', 'data'.
UserData updates the stored object state. Type: Nelson array. Supported values: any Nelson value, including [], numeric arrays, text, cells, structures, or handles.
VerticalAlignment recomputes geometry, limits, or layout. Type: text scalar or character row vector. Supported values: 'left', 'center', 'right'.
Visible updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'on', 'off'.
💡Examples
Create the graphics object and list its properties.
f = figure('Visible', 'off');
ax = axes('Parent', f);
h = text(ax, 0.5, 0.5, 'Label');
names = properties(h);
close(f)
🔗See Also
textpropertiesgetset
🕔Version History
Version Description
-- Property page added.
Edit this page on GitHub