piechart properties
piechart graphics object properties.
📄Description

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

Property Action Type and supported values
CategoryCounts replaces data and recomputes automatic limits that depend on it. Type: numeric, logical, categorical, string, vector, matrix, or table-derived data. Supported values: [] or data with dimensions compatible with the rendered object.
ColorOrder changes automatically selected colors for subsequent plotted series. Type: finite numeric matrix. Supported values: m-by-3 RGB matrix with values in [0,1].
Data replaces data and recomputes automatic limits that depend on it. Type: numeric, logical, categorical, string, vector, matrix, or table-derived data. Supported values: [] or data with dimensions compatible with the rendered object.
DataMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
DataVariable updates the stored object state. Type: text scalar or character row vector. Supported values: empty text or a workspace/table variable name.
Direction updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'normal', 'reverse'.
DisplayOrder changes the displayed order of chart groups or variables. Type: text keyword or ordering vector. Supported values: 'ascend', 'descend', or a vector of display indices supported by the chart.
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'.
ExplodedWedges changes which pie or donut wedges are drawn separated from the center. Type: numeric or logical vector. Supported values: empty value or vector with one element per wedge; nonzero entries offset the matching wedge.
FaceAlpha updates rendered output on the next graphics refresh. Type: numeric scalar or numeric array. Supported values: values in [0,1]; data arrays must match the related rendered data.
FaceColor 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'.
FontColor 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'.
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.
FontSizeMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
HandleVisibility controls whether handle-search functions can find the object. Type: text scalar or character row vector. Supported values: 'on', 'off', 'callback'.
InnerPosition 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].
Interpreter updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'tex', 'none'.
LabelStyle updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: style names defined by this object, such as UI styles, light styles, chart styles, or line styles.
LabelStyleMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
Labels updates rendered output on the next graphics refresh. Type: text scalar, string array, or cell array of text. Supported values: empty text or labels matching the related ticks, categories, variables, lines, or displayed values.
LabelsMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
Layout updates the object placement requested from the parent layout manager. Type: layout options object or empty value. Supported values: layout information stored by parent layout managers, including tile placement data where the object supports tiled layouts.
LegendTitle updates the title displayed above legend entries. Type: text value. Supported values: character row vector, string scalar, or empty text.
LegendVisible updates rendered output on the next graphics refresh. Type: on/off value. Supported values: 'on', 'off', true, or false.
LineWidth updates rendered output on the next graphics refresh. Type: finite numeric scalar. Supported values: value greater than or equal to 0.
Names updates rendered output on the next graphics refresh. Type: text scalar, string array, or cell array of text. Supported values: empty text or labels matching the related ticks, categories, variables, lines, or displayed values.
NamesMode 'auto' lets Nelson recompute the paired property; 'manual' preserves the assigned value. Type: text scalar or character row vector. Supported values: 'auto', 'manual'.
NamesVariable updates the stored object state. Type: text scalar or character row vector. Supported values: empty text or a workspace/table variable name.
NumDisplayWedges 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.
OuterPosition 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].
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.
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].
PositionConstraint 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].
Proportions replaces data and recomputes automatic limits that depend on it. Type: numeric, logical, categorical, string, vector, matrix, or table-derived data. Supported values: [] or data with dimensions compatible with the rendered object.
ShowOthers updates rendered output on the next graphics refresh. Type: on/off value. Supported values: 'on', 'off', true, or false.
SourceTable updates the stored object state. Type: table or empty array. Supported values: [] or a table used by variable-name properties.
StartAngle recomputes geometry, limits, or layout. Type: finite numeric scalar. Supported values: finite scalar value.
Title updates the displayed title or the title object associated with the graphics item. Type: text graphics object or text value, depending on the object class. Supported values: a title text object, character row vector, string scalar, or empty text.
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'.
Visible updates rendered output on the next graphics refresh. Type: text scalar or character row vector. Supported values: 'on', 'off'.
WedgeDisplayData replaces data and recomputes automatic limits that depend on it. Type: numeric, logical, categorical, string, vector, matrix, or table-derived data. Supported values: [] or data with dimensions compatible with the rendered object.
WedgeDisplayNames updates rendered output on the next graphics refresh. Type: text scalar, string array, or cell array of text. Supported values: empty text or labels matching the related ticks, categories, variables, lines, or displayed values.
💡Examples
Create the graphics object and list its properties.
f = figure('Visible', 'off');
h = piechart(f, [1 2 3]);
names = properties(h);
close(f)
🔗See Also
piechartpropertiesgetset
🕔Version History
Version Description
-- Property page added.
Edit this page on GitHub