Graphics Object Properties

Root Properties

Property Name: Description/Values
children: A vector of figure handles, which are children of the root.
currentfigure: The handle of the current figure.
handle: The handle of the root, which is 0.; 0
parent: The parent handle; null for the root object.; 0
type: The type of the root object.; 'root'
units: Units of measurement.; 'pixels' | 'normalized'

Figure Properties

Property Name: Description/Values
bottomlabel: Handle of the label that is placed on the bottom area of the figure.; Note: Use the set command to set the contents of the label.; Type: string | cell.
children: A vector of axes handles, which are the children of the figure.
currentaxes: Handle of the current axes of the figure.
handle: Handle of the figure object.; Integer.
leftlabel: Handle of the label that is placed on the left area of the figure.; Note: Use the set command to set the contents of the label.; Type: string | cell.
parent: Parent handle, which is always 0 (root).; 0
position: Location and size of the figure.; The location is specified by the upper-left point, and the size is specified by the width and height.; Note: This property is only valid for floating figure. If you change this property for a docked figure, there will be no effect, but after undocking the figure, the size/position will be updated accordingly.; [left top width height]
rightlabel: Handle of the label that is placed on the right area of the figure.; Note: Use the set command to set the contents of the label.; Type: string | cell.
toplabel: Handle of the label that is placed on the top area of the figure.; Note: Use the set command to set the contents of the label.; Type: string | cell.
type: Type of figure object.; 'figure'
units: Units of measurement.; 'pixels' | 'normalized'
visible: Visibility of the figure.; 'on' | 'off'

Axes Properties

Property Name: Description/Values
children: A vector of handles, which are the children of the axes.
color: Background color of the axes.; 1*3 matrix of RGB | colorname
contourlevels: Number of colors in the color bar. Maximum number of colors is 32.; Integer
contourtype: Type of contour.; 'blended' | 'discrete' | 'none'
fontangle: Font angle of the axes.; 'regular' | 'italic'
fontname: Axes font name.; Any available font from the system.
fontsize: Font size of the axes.; Integer
fontweight: Font weight of the axes.; 'normal' | 'bold'
handle: Handle of the axes object.; Double
mouseclickcallback: Callback function triggered by a mouse click on a 2D plot.; Function handle
parent: Handle of the parent figure.
plottiptotail (polar plot only): Enable creation of a tip-to-tail curve.; 'off' | 'on'
polarmethod (polar plot only): The polar method of the plot.; 'phasevsmag' | 'vector' | 'radar'
position: Location and size of the axes in the figure.; Location is specified by the upper-left point; size is specified by the width and height; [left top width height]
title: Handle of the title, which is a text object.
type: Type of axes object.; 'axes'
units: Units of measurement.; 'normalized' | 'pixels'
visible: Visibility of the axes.; 'on' | 'off'
xcategories (bar plots only): Labels for the x category axis of a bar plot.; Cell
xcolor: Color of the x axis.; 1*3 matrix of RGB | colorname
xgrid: Status of the x axis grid lines.; 'off' | 'on'
xlabel: Handle of the label of the x axis, which is a text object.
xminorgrid: Status of the x axis minor grid lines.; 'off' | 'on'
xscale: Scale of the x axis.; 'linear' | 'log' | 'db10' | 'db20'
xtick: Number of tics on the x axis.; Integer
ycategories (3D bar plots only): Labels for the y category axis of a 3D bar plot.; Cell
ycolor: Color of the y axis.; 1*3 matrix of RGB | colorname
ygrid: Status of the y axis grid lines.; 'off' | 'on'
ylabel: Handle of the label of y axis, which is a text object.
yminorgrid: Status of the y axis minor grid lines.; 'off' | 'on'
yscale: Scale of the y axis.; 'linear' | 'log' | 'db10' | 'db20'
ytick: Number of tics on the y axis.; Integer
zcolor: Color of the z axis.; 1*3 matrix of RGB | colorname
zgrid: Status of the z axis grid lines.; 'off' | 'on'
zlabel: Handle of the label of z axis, which is a text object.
zminorgrid: Status of the z axis minor grid lines.; 'off' | 'on'
zscale: Scale of the z axis.; 'linear' | 'log' | 'db10' | 'db20'
ztick: Number of tics on the z axis.; Integer

Y-axis Properties

Property Name: Description/Values
children: A vector of handles, which are the children of the axis.
fontangle: Font angle of the axis.; 'regular' | 'italic'
fontname: Font name of the axis.; Any available font from system.
fontsize: Font size of the axis.; Integer
fontweight: Font weight of the axis.; 'normal' | 'bold'
handle: Axis object handle.; Double
parent: Parent axis object handle.
tag: A tag attached to the axis.; String
type: Type of the axis object.; 'axes'
units: Units of measurement.; 'normalized' | 'pixels'
visible: Visibility of the axis.; 'on' | 'off'
ycolor: Axis color.; 1*3 matrix of RGB | colorname
ylabel: Handle of the axis label, which is a text object.
yscale: Axis scale.; 'linear' | 'log' | 'db10' | 'db20'
ytick: Number of ticks on the axis.; Integer

Line Properties

Property Name: Description/Values
children: Children of the line object, currently an empty matrix.
color: Line color.; 1*3 matrix of RGB | colorname
handle: Handle of the line object.
linestyle: The line style.; '-' | '--' | '-.' | ':' | 'none'
linewidth: Width of the line.; Integer
marker: Line marker.; 's' | 'square' | '^' | 'v' | 'x' | 'o' | 'd' | 'diamond' | '+' | '*' | '.' | 'none'
markerfacecolor: Color of the line marker.; 1*3 matrix of RGB | colorname
markersize: Size of the marker.; Integer
parent: Handle of the parent axes.; 0
tiptotail (polar plot only): Enables participation of the line in the tip-to-tail curve.; 'on' | 'off'
type: The type of line object.; 'line'
units: Units of measurement.; 'pixels' | 'normalized'
visible: Visibility of the line.; 'on' | 'off'

Surface Properties

Property Name: Description/Values
children: Children of the surface object, currently an empty matrix.
color: Surface color.; 1*3 matrix of RGB | colorname
handle: Handle of the surface object.
meshlines: Visibility of the surface mesh lines.; 'on' | 'off'
parent: Handle of the parent axes.; 0
type: Surface object type.; 'surface'
units: Units of measurement.; 'pixels' | 'normalized'
visible: Visibility of the surface.; 'on' | 'off'

Text Properties

Property Name: Description/Values
borderwidth: The width of the text's border line.; Integer
children: Children of the text object, currently an empty matrix.
color: The text color.; 1*3 matrix of RGB | colorname
fontangle: The font angle of the text.; 'regular' | 'italic'
fontname: The text's font name.; Any available fonts from the system.
fontsize: The text's font size.; Integer
fontweight: The font weight of the text.; 'normal' | 'bold'
handle: The handle of the text object.; Double
horizontalalignment: The horizontal alignment of the text box relative to the given x,y coordinate. Supported in 2D plots only.; 'center' | 'left' | 'right'
offset: The distance between the given x,y coordinate and the text box. Supported in 2D plots only.; Double
parent: The handle of the parent object.; Double
string: The content of the text object.
type: The text object type.; 'text'
units: The units of measurement.; 'pixels' | 'normalized'
verticalalignment: The vertical alignment of the text box relative to the given x,y coordinate. Supported in 2D plots only.; 'middle' | 'top' | 'bottom'
visible: Visibility of the text object.; 'on' | 'off'

Uicontrol Properties

Property Name: Description/Values
callback: Callback function of the user interface control (uicontrol) object.; Function handle.
children: The children of the uicontrol object, currently an empty matrix.
fontangle: The font angle of the uicontrol.; 'regular' | 'italic'
fontname: The font name of the uicontrol.; Any available font from the system.
fontsize: The font size of the uicontrol.; Integer
fontweight: The font weight of the uicontrol.; 'normal' | 'bold'
handle: The handle of the uicontrol object.
max: The maximum value for the uicontrol.; Integer
min: The minimal value of the uicontrol.; Integer
parent: The handle of the parent object.; Scalar
position: Location and size of the uicontrol in the figure.; Location is specified by the upper-left point; size is specified by the width and height.; [left top width height]
string: Label displayed on the uicontrol object.
tag: User-defined string to the uicontrol object.; String
tooltipstring: Tooltip string displayed when mouse moves over the uicontrol object.; String
type: The uicontrol object type, which is read-only .; 'uicontrol'
units: Units of measurement.; 'pixels' | 'normalized'
value: Current value of the uicontrol.; Integer

Uipanel Properties

Property Name: Description/Values
children: The children of the uipanel object; defaults to an empty matrix.
fontangle: Specifies the angle of the displayed font.; 'regular' | 'italic'
fontname: Specifies name of the displayed font.; String
fontsize: Specifies the size of the displayed font.; Scalar
fontweight: Specifies the weight of the displayed font.; 'normal' | 'bold'; Scalar
handle: The handle of the uipanel object.
parent: The handle of the parent object.; Scalar
position: Location and size of the object in the figure.; Location is specified by the upper-left point; size is specified by the width and height.; [left, top, width, height]
string: Label displayed on the uicontrol object.
tag: User-defined string to the uipanel object.; String
type: The object type.; 'uipanel'
units: Specifies units of measurement.; 'pixels' | 'normalized'
userdata: User-defined numerical data.; Any complex, matrix, or scalar values.
visible: Specifies if the object is visible or not.; 'on' | 'off'

Uitable Properties

Property Name: Description/Values
children: Children of the interface table (uitable) object, currently an empty matrix.
columnname: Column names.; 'numbered'(default) | cell of labels
columnwidth: Width of the table column or 'auto', which is the default.
data: Content of the table.
fontangle: Font angle of the uitable.; 'regular' | 'italic'
fontname: Font name of the uitable.; Any available font from the system.
fontsize: Font size of the uitable.; Integer
fontweight: Font weight of the uitable.; 'normal' | 'bold'
handle: Handle of the uitable object.
parent: Handle of the parent object.; 0
position: Location and size of the user uitable in the figure.; The location is specified by the upper-left point; size is specified by the width and height; [left top width height]
tag: User-defined string to tag graphical control objects.; String
tooltipstring: Tooltip string displayed when the mouse moves over the uicontrol object.; String
type: The type of the uitable table object.; 'uitable'
units: Units of measurement, not used yet.; 'pixels' | 'normalized'
userdata: User-defined matrix data.
visible: Specifies if the table is visible.; 'on' (default) | 'off'

Hggroup Properties

Property Name: Description/Values
areagroup (area plot only): A vector of handles, which point to area groups.
basevalue (area plot only): Base value of the shading.; Double
bargroup (bar plot only): A vector of handles, which point to bar groups.
barlayout (bar plot only): The bar layout style.; 'grouped' | 'stacked'
barwidth (bar plot only): The width of the bars.; Integer
imgrid (imagesc plot only): Visibility of the image grid.; 'off' | 'on'
marker (scatter plot only): marker style; 's' | 'square' | '^' | 'v' | 'x' | 'o' | 'd' | 'diamond' | '+' | '*' | '.' | 'none'
markerfacecolor (scatter plot only): The marker color.; 1*3 matrix of RGB | colorname
children: The children of the hggroup object.
facecolor: The object color.; 1*3 matrix of RGB | colorname
handle: The handle of the hggroup object.
parent: The handle of the parent axes.; 0
type: The type of the hggroup object.; 'hggroup'
units: The units of measurement, currently not used.; 'pixels' | 'normalized'
visible: Visibility of the hggroup object.; 'on' | 'off'

Image Properties

Property Name: Description/Values
children: The children of the image object, currently an empty matrix.
filepath: The filepath.
handle: The handle of the image object.
parent: The handle of the parent object.; 0
position: The location and size of the image in the figure. The location is specified by the upper-left point, and the size is specified by the width and height.; [left top width height]
type: The image object type.; 'image'
units: Units of measurement (not yet used).; 'pixels' | 'normalized'

Shape Properties

Property Name: Description/Values
children: Children of the shape object; an empty matrix for now.
curvature: Curvature for the horizontal and vertical edge.; [h-curvature v-curvature]
edgecolor: Color of the shape's border.; 1*3 matrix of RGB | colorname
facecolor: Color to fill the shape.; 1*3 matrix of RGB | colorname
handle: Handle of the shape object.; Double
linestyle: Edge style.; '-' | '--' | '-.' | ':' | 'none'
linewidth: Edge width.; Integer
parent: handle of the parent object, which is a handle of the figure.; Integer
position: Location and size of the shape in the figure. Location is specified by the upper-left point, size is specified by the width and height.; [left top width height]
tag: A tag attached to the shape.; String
type: Shape object type.; 'hggroug'
units: Units of measurement, (currently not used).; 'pixels' | 'normalized'
visible: Shape visibility.; 'on' | 'off'