Graphics Object Properties

Properties for the graphics object in OML.

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
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
parent
The parent handle; null for the root object.
0
screendepth
The color depth of the screen. Read-only.
Integer
screenpixelsperinch
The number of pixels per inch of the screen. Read-only.
Double
screensize
The size (resolution) of the screen. Read-only.
[1 1 width height]
showhiddenhandles
If set to 'on' then all objects in the hierarchy are listed in their parents' 'children' value regardless of their 'handlevisibility' value.
'off' | 'on'
tag
A tag attached to the root object.
String
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.
string | cell
children
A vector of axes handles, which are the children of the figure.
color
The background color of the figure.
1*3 matrix of RGB | colorname
createfcn
Function triggered when the figure object is created.
Function handle, string, or cell specifying function name and arguments.
currentaxes
Handle of the current axes of the figure.
currentpoint
The position of the mouse in pixels. The value is updated on mouse click before the 'windowbuttondownfcn' and 'windowbuttonupfcn' are called. 'Currentpoint' is also updated on mouse move if the 'windowbuttonmotionfcn' is set.
[x, y]
deletefcn
Function triggered when the figure object is deleted.
Function handle, string, or cell specifying function name and arguments.
filename
The '.fig' file that was used to create the figure.
String
handle
Handle of the figure object.
Integer.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
interruptible
Determines if a callback associated with this figure is interruptible by the user or not.
'off' | 'on'
keypressfcn
Function triggered when there is a key press event on the figure object. The function is triggered only if the figure has focus.
Function handle, string, or cell specifying function name and arguments.
keyreleasefcn
Function triggered when there is a key release event on the figure object. The function is triggered only if the figure has focus.
Function handle, string, or cell specifying function name and arguments.
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.
string | cell
name
Name of the figure.
String
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]
resize
Enable or disable the resizing of the figure window when the figure is undocked. If resize is set to 'off', the figure can still be resized by setting the 'position' property.
'on' | 'off'
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.
string | cell
sizechangedfcn
Function triggered when the figure window is resized.
Function handle, string, or cell specifying function name and arguments.
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.
string | cell
tag
A tag attached to the figure object.
String
type
Type of figure object.
'figure'
units
Units of measurement.
'pixels' | 'normalized'
uicontextmenu
Handle of the uicontextmenu object associated with this figure, if it exists.
visible
Visibility of the figure.
'on' | 'off'
windowicon
Path to an image file that is shown at the top-left corner of the figure window. Supported file types are: .ico, .jpg, .jpeg, .png.
Note: The icon will be visible only if the figure is undocked.
String
windowbuttondownfcn
Function triggered when there is a mouse button press event on the figure object.
Function handle, string, or cell specifying function name and arguments.
windowbuttonmotionfcn
Function triggered when the mouse is moving inside the figure area.
Function handle, string, or cell specifying function name and arguments.
windowbuttonupfcn
Function triggered when there is a mouse button release event on the figure object.
Function handle, string, or cell specifying function name and arguments.
windowkeypressfcn
Function triggered when there is a key press event on the figure object. The function is triggered if the figure or its children have focus.
Function handle, string, or cell specifying function name and arguments.
windowkeyreleasefcn
Function triggered when there is a key release event on the figure object. The function is triggered if the figure or its children have focus.
Function handle, string, or cell specifying function name and arguments.
windowscrollwheelfcn
Function triggered when there is a mouse wheel event on the figure object.
Function handle, string, or cell specifying function name and arguments.
windowstyle
Display style of the figure window.
Note: The 'modal' option will undock the figure window and bring it to the front. Interaction with other windows of the application will be blocked until the figure is closed.
'docked' | 'undocked' | 'modal'

Axes Properties

Property Name
Description/Values
bargap (2D bar plot only)
Gap between bars.
Integer
barlabels (2D bar chart plot only)
Show the value over each bar.
'off' | 'on'
barlabelsfontangle (2D bar chart plot only)
Font angle for the bar labels.
'regular' | 'italic'
barlabelsfontname (2D bar chart plot only)
Font name for the bar labels.
Any available font from the system.
barlabelsfontsize (2D bar chart plot only)
Font size for the bar labels.
Integer
barlabelsfontweight (2D bar chart plot only)
Font weight for the bar labels.
'normal' | 'bold'
barorientation (2D bar chart plot only)
Orientation of the bars.
'horizontal' | 'vertical'
children
A vector of handles, which are the children of the axes.
clim
Range of the colorbar.
2-element vector
color
Background color of the axes.
1*3 matrix of RGB | colorname
colorbar
Handle of the colorbar object.
Double
colorbarscale
Scale of the colorbar values.
'linear' | 'log' | 'db10' | 'db20'
colorlevels
The colorbar values.
Note: The set command for this property accepts either an integer or a real vector. Use a real vector to set custom values to the colorbar. Use an integer to define the number of colors in the colorbar. In this case, the range and values of the colorbar are automatically calculated.
Integer or real vector.
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'
framecolor
Frame color.
1*3 matrix of RGB.
gridcolor
Grid line color.
1*3 matrix of RGB.
handle
Handle of the axes object.
Double
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
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.
tag
A tag attached to the axes object.
String
type
Type of axes object.
'axes'
units
Units of measurement.
'normalized' | 'pixels'
visible
Visibility of the axes.
'on' | 'off'
xaxislocation
X axis location.
'bottom' | 'top'
xcategories (bar chart 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
xdb10reference (2D plots only)
Reference value for the x axis dB10 scale. Data values are scaled using the formula: value = 10*log10(original_value/reference)
Scalar
xdb20reference (2D plots only)
Reference value for the x axis dB20 scale. Data values are scaled using the formula: value = 20*log10(original_value/reference)
Scalar
xdir (2D plots only)
X axis direction.
'normal' | 'reverse'
xfontangle
Font angle of the x axis tick labels.
'regular' | 'italic'
xfontname
Font name of the x axis tick labels.
Any available font from the system.
xfontsize
Font size of the x axis tick labels.
Integer
xfontweight
Font weight of the x axis tick labels.
'normal' | 'bold'
xgrid
Status of the x axis grid lines.
'off' | 'on'
xlabel
Handle of the label of the x axis, which is a text object.
xlim
X axis limits.
2-element vector
xminorgrid
Status of the x axis minor grid lines.
'off' | 'on'
xminortick
Number of ticks on the x minor axis.
Integer
xnumericformat
Displays the format of the x axis values.
'auto' | 'fixed' | 'scientific'
xnumericprecision
Number of digits following the decimal point of the x axis values.
Integer
xscale
Scale of the x axis.
'linear' | 'log' | 'db10' | 'db20'
xtick
Number of ticks on the x axis or vector of tick values to display on the x axis. Custom tick values can be set only on the linear axis of 2D plots.
Note: If the axis scale is logarithmic, decibels, or dB10, this property refers to ticks per decade. The accepted values are:
  • 0, 1, 2, 5, 9 or 18 for logarithmic.
  • 0, 1, 2, 4, 10 or 20 for decibels.
  • 0, 1, 2, 4 or 10 for dB10.
Integer | Vector
xticklabel
Labels of the x axis ticks.
Note: The labels are set on the custom ticks that are specified by the xtick property.
Cell of strings
xtickmethod
The method for calculating the number of ticks on the x axis.
'increment' | 'ticks'
xvisible
Specifies if the x axis is visible.
'on' | 'off'
xweighting (2D plots only)
Weighting method for the dB10 and dB20 x axis scale.
Note: For more information about the weighting methods refer to the dba, dbb, dbc and dbu commands.
'none' | 'a' | 'b' | 'c' | 'u'
yaxislocation
Y axis location.
'left' | 'right'
ycategories (3D bar chart plots only)
Labels for the y category axis of a 3D bar chart plot.
Cell
ycolor
Color of the y axis.
1*3 matrix of RGB | colorname
ydb10reference (2D plots only)
Reference value for the y axis dB10 scale. Data values are scaled using the formula: value = 10*log10(original_value/reference)
Scalar
ydb20reference (2D plots only)
Reference value for the y axis dB20 scale. Data values are scaled using the formula: value = 20*log10(original_value/reference)
Scalar
ydir (2D plots only)
Y axis direction.
'normal' | 'reverse'
yfontangle
Font angle of the y axis tick labels.
'regular' | 'italic'
yfontname
Font name of the y axis tick labels.
Any available font from the system.
yfontsize
Font size of the y axis tick labels.
Integer
yfontweight
Font weight of the y axis tick labels.
'normal' | 'bold'
ygrid
Status of the y axis grid lines.
'off' | 'on'
ylabel
Handle of the label of y axis, which is a text object.
ylim
Y axis limits.
2-element vector
yminorgrid
Status of the y axis minor grid lines.
'off' | 'on'
yminortick
Number of ticks on the y minor axis.
Integer
ynumericformat
Display format of the y axis values.
'auto' | 'fixed' | 'scientific'
ynumericprecision
Number of digits following the decimal point of the y axis values.
Integer
yscale
Scale of the y axis.
'linear' | 'log' | 'db10' | 'db20'
ytick
Number of ticks on the y axis or vector of tick values to display on the y axis. Custom tick values can be set only on the linear axis of 2D plots.
Note: If the axis scale is logarithmic, decibels, or dB10, this property refers to ticks per decade and the accepted values are:
  • 0, 1, 2, 5, 9 or 18 for logarithmic.
  • 0, 1, 2, 4, 10 or 20 for decibels.
  • 0, 1, 2, 4 or 10 for dB10.
Integer | Vector
yticklabel
Labels of the y axis ticks.
Note: The labels are set on the custom ticks that are specified by the ytick property.
Cell of strings
ytickmethod
The method for calculating the number of ticks for the y axis.
'increment' | 'ticks'
yvisible
Specifies if the y axis is visible.
'on' | 'off'
yweighting (2D plots only)
Weighting method for the dB10 and dB20 y axis scale.
Note: For more information about the weighting methods refer to the dba, dbb, dbc and dbu commands.
'none' | 'a' | 'b' | 'c' | 'u'
zcolor
Color of the z axis.
1*3 matrix of RGB | colorname
zerolinecolor
Zero line color.
1*3 matrix of RGB.
zfontangle
Font angle of the z axis tick labels.
'regular' | 'italic'
zfontname
Font name of the z axis tick labels.
Any available font from the system.
zfontsize
Font size of the z axis tick labels.
Integer
zfontweight
Font weight of the z axis tick labels.
'normal' | 'bold'
zgrid
Status of the z axis grid lines.
'off' | 'on'
zlabel
Handle of the label of z axis, which is a text object.
zlim
Z axis limits.
2-element vector
zminorgrid
Status of the z axis minor grid lines.
'off' | 'on'
zminortick
Number of ticks on the z minor axis.
Integer
znumericformat
Display format of the z axis values.
'auto' | 'fixed' | 'scientific'
znumericprecision
Number of digits following the decimal point of the z axis values.
Integer
zscale
Scale of the z axis.
'linear' | 'log' | 'db10' | 'db20'
ztick
Number of tics on the z axis.
Note: If the axis scale is logarithmic, decibels, or dB10, this property refers to tics per decade and the accepted values are:
  • 0, 1, 2, 5, 9 or 18 for logarithmic.
  • 0, 1, 2, 4, 10 or 20 for decibels.
  • 0, 1, 2, 4 or 10 for dB10.
Integer
ztickmethod
The method for calculating the number of ticks for the z axis.
'increment' | 'ticks'
zvisible
Specifies if the z axis is visible.
'on' | 'off'

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 object.
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
ydb10reference (2D plots only)
Reference value for the y axis dB10 scale. Data values are scaled using the formula: value = 10*log10(original_value/reference)
Scalar
ydb20reference (2D plots only)
Reference value for the y axis dB20 scale. Data values are scaled using the formula: value = 20*log10(original_value/reference)
Scalar
ydir
Axis direction.
'normal' | 'reverse'
ylabel
Handle of the axis label, which is a text object.
yscale
Axis scale.
'linear' | 'log' | 'db10' | 'db20'
ytick
Number of ticks on the y axis or vector of tick values to display on the y axis. Custom tick values can be set only on the linear axis of 2D plots.
Note: If the axis scale is logarithmic, decibels, or dB10, this property refers to ticks per decade and the accepted values are:
  • 0, 1, 2, 5, 9 or 18 for logarithmic.
  • 0, 1, 2, 4, 10 or 20 for decibels.
  • 0, 1, 2, 4 or 10 for dB10.
Integer | Vector
yticklabel
Labels of the y axis ticks.
Note: The labels are set on the custom ticks that are specified by the ytick property.
Cell of strings
ytickmethod
The method for calculating the number of ticks for the y axis.
'increment' | 'ticks'
yweighting (2D plots only)
Weighting method for the dB10 and dB20 y axis scale.
Note: For more information about the weighting methods refer to the dba, dbb, dbc and dbu commands.
'none' | 'a' | 'b' | 'c' | 'u'

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
dataxoffset
Shifts the data along the x axis.
Double
datayoffset
Shifts the data along the y axis.
Double
datazoffset
Shifts the data along the z axis.
Double
dataxscale
Scales the data in the x axis.
Double
datayscale
Scales the data in the y axis.
Double
datazscale
Scales the data in the z axis.
Double
displayname
The line's name.
String
handle
Handle of the line object.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
linestyle
The line style.
'-' | '--' | '-.' | ':' | '-:' | 'none'
linewidth
Width of the line.
Integer
marker
Line marker.
's' | 'square' | '^' | 'v' | 'x' | 'o' | 'd' | 'diamond' | '+' | '*' | '.' | 'none'
markerevery
Frequency of line markers.
Integer
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
tag
A tag attached to the line object.
String
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'
xdata
Data values associated with the x axis.
vector
yaxis
Handle of the vertical axis this object is plotted on.
Double
ydata
Data values associated with the y axis.
vector
zdata
Data values associated with the z axis (3D lines only).
vector

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
displayname
The surface's name.
String
edgecolor
Mesh line color.
1*3 matrix of RGB | colorname
handle
Handle of the surface object.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
linewidth (waterfall plot only)
Width of the waterfall lines.
Integer
meshlines
Visibility of the surface mesh lines.
'on' | 'off'
parent
Handle of the parent axes.
0
tag
A tag attached to the surface object.
String
type
Surface object type.
'surface'
units
Units of measurement.
'pixels' | 'normalized'
visible
Visibility of the surface.
'on' | 'off'
xdata
Data values associated with the x axis.
vector | matrix
ydata
Data values associated with the y axis.
vector | matrix
zdata
Data values associated with the z axis.
matrix

Text Properties

Property Name
Description/Values
attached
Enables the attachement of the text box to a point. Supported in 2D plots only.
'on' | 'off'
backgroundcolor
The background color of the text box.
1*3 matrix of RGB | colorname
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
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
horizontalalignment
The horizontal alignment of the text box relative to the given x,y coordinate. Supported in 2D plots only.
'center' | 'left' | 'right'
interpreter
The interpreter that will be used to process the text. Supported in 2D plots only.
Note: The 'tex' interpreter supports a subset of the TeX markup language and is currently available in 2D plots for title, axis labels and text objects. Mathematical expressions should be placed inside '$'. Examples may be found in the documation of the text command.
'none' | 'tex'
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.
tag
A tag attached to the text object.
String
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'

uicontextmenu Properties

Property Name
Description/Values
callback
Callback function of the uicontextmenu object.
Function handle, string or cell reprepresenting the callback.
children
Children of the uicontextmenu object, which are the added uicontextmenuitem objects.
Real vector.
createfcn
Function triggered when the uicontextmenu object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uicontextmenu object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uicontextmenu object is enabled, default value being 'on'
'on' (default) | 'off'
handle
Handle of the uicontextmenu object.
parent
Handle of the parent object.
position
Index the uicontextmenu in the parent.
Positive integer.
separator
Indicates if there needs to be a separator added before the uicontextmenuitem object, if applicable.
'off' (default) | 'on'
tag
User-defined string to tag graphical control objects.
String
type
The type of the uicontextmenu object.
'uicontextmenu'
userdata
User-defined matrix data
visible
Specifies if uicontextmenu object is visible
'on'(default) | 'off'

uicontextmenuitem Properties

Property Name
Description/Values
callback
Callback function of the uicontextmenuitem object.
Function handle, string or cell reprepresenting the callback.
children
Children of the uicontextmenuitem object.
Real vector.
createfcn
Function triggered when the uicontextmenuitem object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uicontextmenuitem object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uicontextmenuitem is enabled.
'on' (default) | 'off'
handle
Handle of the uicontextmenuitem object.
parent
Handle of the uicontextmenu/uicontextmenuitem parent object.
position
Index of the uicontextmenuitem object in the parent.
Positive integer.
separator
Indicates if there needs to be a separator added before the uicontextmenuitem object, if applicable.
'off' (default) | 'on'
tag
User-defined string to tag graphical objects.
String
type
The type of the object.
'uicontextmenuitem'
userdata
User-defined matrix data
visible
Specifies if uitabgroup is visible
'on'(default) | 'off'

uicontrol Properties

Property Name
Description/Values
aspectratio
Specifies if the aspect ratio of a background image is ignored ('off') or kept ('on'). Valid only for styles pushbutton, togglebutton and frame.
'off' (default) | 'on'
backgroundcolor
Background color of the object.
String or real vector.
backgroundimage
Background image that can be displayed on the uicontrol object. This is valid only for styles 'pushbutton' or 'frame'.
String.
callback
Callback function of the user interface control (uicontrol) object.
Function handle, string, or cell specifying function name and arguments.
createfcn
Function triggered when the uicontrol object is created.
Function handle, string, or cell specifying function name and arguments.
deletefcn
Function triggered when the uicontrol object is deleted.
Function handle, string, or cell specifying function name and arguments.
children
The children of the uicontrol object, currently an empty matrix.
enable
Indicates if the uicontrol object is enabled; default value is 'on'.
'on' (default) | 'off'
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
fontunits
Units of measurement for fontsize.
'pixels' (default) | 'normalized'
fontweight
The font weight of the uicontrol.
'normal' | 'bold'
handle
The handle of the uicontrol object.
horizontalalignment
Horizontal alignment of the text in styles edit, text, pushbutton and textedit.
left (default) | right | center | justify
interruptible
Determines if a callback associated with this uicontrol is interruptible by the user or not.
'off' (default) | 'on'
keypressfcn
Function triggered when there is a key press event on the user interface control (uicontrol) object.
Function handle, string, or cell specifying function name and arguments.
max
The maximum value for the uicontrol.
Integer
min
The minimal value of the uicontrol.
Integer
orient
Orientation of the uicontrol of a style slider.
'horizontal' (default) | 'vertical'
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]
sliderstep
The value of a single step and a single page of the uicontrol style slider.
string
Label displayed on the uicontrol object.
style
Style of the uicontrol object.
tag
User-defined string to the uicontrol object.
String
tickinterval
Interval between tickmarks of the uicontrol style slider.
0 (default) | any positive integer
tickmarks
Position of tickmarks of the uicontrol slider.
'nomarks' (default) | 'above' | 'below' | 'both'
tooltipstring
Tooltip string displayed when mouse moves over the uicontrol object.
String
tracking
Specifies if the value of a uicontrol slider is tracked and the callback is executed as it is dragged.
'on' (default) | 'off'
type
The uicontrol object type, which is read-only .
'uicontrol'
uicontextmenu
Handle of the uicontextmenu object associated with this object, if it is applicable for this style and if it exists.
units
Units of measurement.
'pixels' | 'normalized'
userdata
User-defined matrix data.
Complex, double, or matrix
value
Current value of the uicontrol.
Integer
verticalalignment
Vertical alignment of the text in styles edit and text.
top | bottom | middle(default)
visible
Specifies if the uicontrol widget is visible.
on (default) | off

uipushtool Properties

Property Name
Description/Values
children
Children of the uipushtool object.
Real vector.
clickedcallback
Callback function triggered when the uipushtool object is clicked.
Function handle, string or cell specifying function name and arguments.
createfcn
Function triggered when the uipushtool object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uipushtool object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the uipushtool object is enabled.
on (default) | off
String.
handle
Read-only handle of the uipushtool object.
Scalar.
iconpath
Path to the icon displayed on the uipushtool object.
String.
keypressfcn
Function triggered when a key is pressed on the uipushtool object.
Function handle, string or cell specifying function name and arguments.
parent
Handle of the parent uitoolbarobject.
position
Read-only index of the uipushtool object in the parent, uitoolbar.
Positive integer.
separator
Specifies if a separator needs to be added after the uipushtool object in the parent uitoolbar.
on | off (default)
String.
tag
User-defined string to tag the uipushtool object.
String.
tooltipstring
Tool tip on the uipushtool object.
String.
type
Read-only type of the uipushtool object.
uipushtool
String.
uicontextmenu
Read-only handle of the uicontextmenu associated with this uipushtool object, if it exists.
Scalar.
userdata
User-defined matrix data.
Complex, matrix or scalar.
value
User-defined scalar data.
Scalar.
visible
Indicates if the uipushtool object is visible.
on (default) | off
String.

uitoggletool Properties

Property Name
Description/Values
children
Children of the uitoggletool object.
Real vector.
clickedcallback
Callback function triggered when the uitoggletool object is clicked.
Function handle, string or cell specifying function name and arguments.
createfcn
Function triggered when the uitoggletool object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uitoggletool object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the uitoggletool object is enabled.
on (default) | off
String.
handle
Read only handle of the uitoggletool object.
Scalar.
iconpath
Path to the icon displayed on the uitoggletool object.
String.
keypressfcn
Function triggered when a key is pressed on the uitoggletool object.
Function handle, string or cell specifying function name and arguments.
offcallback
Callback function triggered when the uitoggletool is off.
Function handle, string or cell specifying function name and arguments.
oncallback
Callback function triggered when the uitoggletool is on.
Function handle, string or cell specifying function name and arguments.
parent
Handle of the parent uitoolbarobject.
position
Read-only index of the uitoggletool object in the parent, uitoolbar.
Positive integer.
separator
Specifies if a separator needs to be added after the uipushtool object in the parent uitoolbar.
on | off (default)
String.
tag
User-defined string to tag the uitoggletool object.
String.
tooltipstring
Tool tip on the uitoggletool object.
String.
type
Read only type of the uitoggletool object.
uitoggletool
String.
uicontextmenu
Read only handle of the uicontextmenu associated with this uitoggletool object, if it exists.
Scalar.
userdata
User defined matrix data.
Complex, matrix or scalar.
value
User defined scalar data.
Scalar.
visible
Indicates if the uitoggletool object is visible.
on (default) | off
String.

uimenuitem Properties

Property Name
Description/Values
callback
Callback function of the uimenuitem object.
Function handle, string or cell reprepresenting the callback.
children
Children of the uimenuitem object.
Real vector.
createfcn
Function triggered when the uimenuitem object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uimenuitem object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uicmenuitem is enabled.
'on' (default) | 'off'
handle
Handle of the uimenuitem object.
Double
label
Label of the uimenuitem object.
String
parent
Handle of the uimenu/uimenuitem parent object.
Double
position
Index of the uimenuitem object in the parent.
Positive integer.
separator
Indicates if there needs to be a separator added before the uimenuitem object, if applicable.
'off' (default) | 'on'
tag
User-defined string to tag graphical objects.
String
type
The type of the object.
'uimenuitem'
userdata
User-defined matrix data
visible
Specifies if uimenuitem is visible
'on'(default) | 'off'

uipanel Properties

Property Name
Description/Values
aspectratio
Specifies if the aspect ratio of a background image is ignored (off(off)) or retained (on).
off (default) | on
backgroundcolor
Background color of the object.
String or real vector.
backgroundimage
Path to a valid image file which is shown in the background of the uipanel object.
String.
bordertype
Specifies the border type.
beveledin | beveledout | etchedin (default) | etchedout | line | none
String.
borderwidth
Specifies the border width, default value is 1.
Integer.
children
The children of the uipanel object; defaults to an empty matrix.
createfcn
Function triggered when the uipanel object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uipanel object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the uipanel object is enabled.
on (default) | off
fontangle
Specifies the angle of the displayed font.
regular (default) | italic
String.
fontname
Specifies name of the displayed font.
String.
fontsize
Specifies the size of the displayed font.
Scalar.
fontunits
Units of measurement for fontsize.
pixels (default) | normalized
String.
fontweight
Specifies the weight of the displayed font.
normal (default) | bold
String.
handle
Read only handle of the uipanel object.
Scalar.
keypressfcn
Function triggered when there is a key pressed on the uipanel object.
Function handle, string or cell specifying function name and arguments.
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 uipanel object.
String.
tag
User-defined string to tag the uipanel object.
String.
type
Read-only property indicating the object type.
uipanel
String.
uicontextmenu
Read only handle of the uicontextmenu object associated with this object.
Scalar.
units
Specifies units of measurement.
pixels (default) | normalized
String.
userdata
User-defined numerical data.
Any complex, matrix, or scalar values.
value
User-defined scalar data.
Scalar.
visible
Specifies if the object is visible or not.
'on' | 'off'

uisearchbox Properties

Property Name
Description/Values
backgroundcolor
Background color of the uisearchbox.
String or real vector.
children
Read-only property listing the children of the uisearchbox object; defaults to an empty matrix.
createfcn
Function executed when the uisearchbox object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function excuted when the uisearchbox object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the uisearchbox object is enabled.
'on' (default) | 'off'
fontangle
Angle of the displayed font.
'regular' (default) | 'italic'
fontname
Name of the displayed font.
String
fontsize
Size of the displayed font.
Scalar
fontunits
Units of measurement for fontsize.
'pixels' (default) | 'normalized'
fontweight
Weight of the displayed font.
'normal' (default) | 'bold'
Scalar
foregroundcolor
Foreground color of the uisearchbox.
String or real vector.
handle
Read-only property specifying the handle of the uisearchbox object.
horizontalalignment
Horizontal alignment of the text in uisearchbox object.
left (default) | right | center | justify
iconposition
Position of the search icon in uisearchbox object.
leading (default) | trailing
matchcase
Specifies if case is matched during a search.
'off' (default) | 'on'
matchpattern
Pattern used for matching.
String.
matchpositions
Read-only property containing the positions in the searchobj where the matchpattern is found.
Cell array or vector.
matchvalues
Read-only property containing the values in the searchobj which matched the matchpattern.
Cell array.
parent
The handle of the parent object.
Scalar
position
Location and size of the object.
Location is specified by the upper-left point; size is specified by the width and height.
[left, top, width, height]
searchobj
Handle of the listbox, popupmenu or uitable which needs to be searched.
syntax
Syntax of the search. 'wildcards' specifies a simple pattern matching syntax used in command shells and regexp specifies a rich Perl-like pattern.
'wildcards'(default) | 'regexp'.
tag
User-defined string to tag the uisearchbox object.
String
tooltipstring
Tooltip displayed when the mouse moves over the uisearchbox object.
String
type
Read-only property specifying the type of the uisearchobj
'uisearchbox'
uicontextmenu
Specifies the uicontextmenu object associated with the uisearchbox.
Scalar
units
Specifies units of measurement.
'pixels' | 'normalized'
userdata
User-defined numerical data.
Any complex, matrix, or scalar values.
value
User-defined scalar value.
Scalar.
verticalalignment
Vertical alignment of the text in the uisearchbox.
top | bottom | middle(default)
visible
Specifies if the object is visible.
'on' (default) | 'off'

uispinbox Properties

Property Name
Description/Values
backgroundcolor
Background color of the spin box.
String or real vector.
callback
Callback function of the spin box.
Function handle, string, or cell specifying function name and arguments.
createfcn
Function triggered when the uispinbox object is created.
Function handle, string, or cell specifying function name and arguments.
deletefcn
Function triggered when the uispinbox object is deleted.
Function handle, string, or cell specifying function name and arguments.
children
Read-only property specifying the children of the uispinbox object.
Real matrix
enable
Indicates if the uispinbox object is enabled.
on (default) | off
fontangle
The font angle of the uispinbox.
regular (default) | italic
fontname
The font name of the uispinbox.
Any available font from the system.
String
fontsize
The font size of the uispinbox.
Integer
fontunits
Units of measurement for fontsize.
pixels (default) | normalized
fontweight
The font weight of the uispinbox.
normal (default) | bold
foregroundcolor
Foreground color of the spin box.
String or real vector.
handle
Read-only property specifying the handle of the uispinbox object.
Scalar
horizontalalignment
Horizontal alignment of the text in uispinbox object.
left (default) | right | center | justify
interruptible
Determines if a callback associated with this spin box is interruptible by the user or not.
off (default) | on
keypressfcn
Function triggered when there is a key press event on the spin box.
Function handle, string, or cell specifying function name and arguments.
linestep
The value of a single step when the spin box is incremented or decremented. Default value is 1.
Integer
max
The maximum value for the spin box.
Integer
min
The minimal value of the spin box.
Integer
parent
The handle of the parent object.
Scalar
position
Location and size of the spin box in the figure.
Location is specified by the upper-left point; size is specified by the width and height.
[left top width height]
Real vector
prefix
String prepended to the display value of the spin box.
String
style
Read-only property specifying the style.
uispinbox
suffix
String appended to the display value of the spin box.
String
tag
User-defined string.
String
tooltipstring
Tooltip string displayed when mouse moves over the spin box.
String
type
Read-only property specifying the type of the spin box object.
uicontrol
uicontextmenu
Read-only property containing the handle of the uicontextmenu object associated with this object.
Scalar
units
Units of measurement.
pixels | normalized
userdata
User-defined matrix data.
Complex, double, or matrix
value
Current value of the spin box.
Integer
verticalalignment
Vertical alignment of the text in the spin box.
top | bottom | middle(default)
visible
Specifies if the uispinbox object is visible.
on (default) | off
wrapping
Specifies if the max and min values of the spinbox are wrapped, behaving as a circular spinbox instead of a directional spinbox.
off (default) | on

uitab Properties

Property Name
Description/Values
children
Children of the uitab object.
Real vector.
createfcn
Function triggered when the uitab object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uitab object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uitab is enabled.
'on' (default) | 'off'
fontangle
Font angle; applies to all uitabs in this group.
'regular' (default) | 'italic'
fontname
Font name; applies to all uitabs in this group.
Any available font from the system.
fontsize
Font size; applies to all uitabs in this group.
Integer
fontunits
Units of measurement for fontsize.
'pixels' (default) | 'normalized'
fontweight
Font weight; applies to all uitabs in this group.
'normal' (default) | 'bold'
handle
Handle of the uitab object.
iconpath
Path to the icon to be displayed next to the tab name.
String
parent
Handle of the uitabgroup parent object.
position
Location and size of the uitab object.
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 uitab object.
String
title
Title of the uitab object.
String
type
The type of the uitab object.
'uitab'
uicontextmenu
Handle of the uicontextmenu object associated with this tab, if it exists.
units
Units of measurement.
'pixels' | 'normalized'
userdata
User-defined matrix data.

uitabgroup Properties

Property Name
Description/Values
children
Children of the uitabgroup object.
Real vector.
createfcn
Function triggered when the uitabgroup object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uitabgroup object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uitabgroup object is enabled.
on (default) | off
fontangle
Font angle of the uitabgroup object; applies to all uitabs in this group.
regular (default) | italic
fontname
Font name of the uitabgroup object; applies to all uitabs in this group.
Any available font from the system.
fontsize
Font size of the uitabgroup object; applies to all uitabs in this group.
Integer
fontunits
Units of measurement for fontsize.
pixels (default) | normalized
fontweight
Font weight of the uitabgroup object; applies to all uitabs in this group.
normal (default) | bold
handle
Handle of the uitabgroup object.
interruptible
Specifies if selectionchangedfcn callback is interruptible.
off (default) | on
parent
Handle of the parent object.
position
Location and size of the uitabgroup object in the parent.
The location is specified by the upper-left point; size is specified by the width and height.
[left top width height]
selectedtab
Handle of the uitab child object is the current tab.
Scalar
selectionchangedfcn
Function triggered when a uitab child is current/selected.
Function handle, string or cell specifying function name and arguments.
style
Read only style of the uitabgroup object.
uitabgroup
tag
User defined string to tag the uitabgroup object.
String
tooltipstring
Tooltip string.
String
type
Read only type of the uitabgroup object.
uitabgroup
uicontextmenu
Specifies the uicontextmenu object associated with the uitabgroup object.
Scalar
units
Units of measurement.
pixels (default) | normalized
userdata
User defined matrix data.
Scalar, complex or matrix.
vlue
User defined scalar data.
Scalar.
visible
Specifies if the uitabgroup object is visible.
on(default) | off

uitable Properties

Property Name
Description/Values
backgroundcolor
Background color of the object.
String or real vector.
celleditcallback
Callback function when the value of a cell is changed in uitable.
Function handle or string.
cellselectioncallback
Callback function triggered when cell selection changes.
Function handle or string.
children
Read-only matrix containing the handles of the children of uitable.
Real matrix.
columneditable
true or false, indicating which column(s) are editable.
Logical matrix.
columnformat
Cell with values of char, logical, numeric, [] or cell array of strings. This property can be used to format text alignment, auto-create checkboxes or popupmenus for a column.
Cell array.
columnname
Column names.
numbered(default) | cell of label(s).
Cell array.
columnwidth
Width of the table column(s) or auto(default).
Cell array | auto.
createfcn
Function triggered when the uitable object is created.
Function handle, string or cell specifying function name and arguments.
data
Table contents.
Cell array | matrix
deletefcn
Function triggered when the uitable object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the table is enabled.
on(default) | off.
fontangle
Specifies the angle of the displayed font.
regular(default) | italic
fontname
Specifies the name of the displayed font.
String
fontsize
Specifies the size of the displayed font.
Scalar
fontunits
Units of measurement for fontsize.
pixels(default) | normalized
fontweight
Specifies the weight of the displayed font.
normal(default) | bold
foregroundcolor
Foreground color of uitable.
String or real vector.
handle
The handle of the uitable object.
headerformat
Format for header labels.
[](default, center justified) | char(left justified) | logical(center justified checkbox) | numeric(right justified)
cell
interruptible
Specifies if celleditcallback and cellselectioncallback functions can be interrupted.
off(default) | on
keypressfcn
Function triggered when there is a key press event on the uitable object.
Function handle, string or cell specifying function name and arguments.
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]
rowheight
Height of the table row(s) or auto, which is the default.
Cell | auto (default)
rowname
Row label(s).
numbered(default) | cell of label(s).
rowstriping
If rowstriping is on, alternate rows will have a different background color. This property is available only on Windows.
off(default) | on.
showgrid
Indicates if the grid on the uitable object is shown.
on(default) | off.
tag
User-defined string to tag the uitable object.
String
tooltipstring
Tooltip string displayed when the mouse moves over the uitable object.
String
type
The object type.
uitable
units
Specifies units of measurement.
pixels(default) | normalized
userdata
User-defined numerical data.
Any complex, matrix, or scalar values.
value
User-defined scalar data.
Scalar.
visible
Specifies if the uitable object is visible.
on(default) | off

uitoolbar Properties

Property Name
Description/Values
children
Read-only property listing the children of the uitoolbar object; defaults to an empty matrix.
createfcn
Function executed when the uitoolbar object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function excuted when the uitoolbar object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if the uitoolbar object is enabled.
on (default) | off
handle
Read-only property specifying the handle of the uitoolbar object.
iconsize
Specifies the size of the uipushtool icons.
Positive integer.
orient
Orientation of the uitoolbar.
horizontal (default) | vertical
parent
The handle of the parent object.
Scalar
position
Location of the object specified by the upper-left point.
[left top]
tag
User-defined string to tag the uitoolbar object.
String
tooltipstring
Tooltip.
String
type
Read-only property specifying the type of the object.
uitoolbar
uicontextmenu
Specifies the uicontextmenu object associated with the uitoolbar.
Scalar
units
Specifies units of measurement.
pixels (default) | normalized
userdata
User-defined numerical data.
Any complex, matrix, or scalar values.
value
User-defined scalar value.
Scalar.
visible
Specifies if the object is visible.
on (default) | off

uitree Properties

Property Name
Description/Values
backgroundcolor
Color of the text displayed in the background of the uitree.
3-element integral vector.
callback
Callback function that is triggered when interacting with the uitree object.
Function handle, string or cell specifying function name and argument(s).
createfcn
Function triggered when the uitree object is created.
Function handle, string or cell specifying function name and arguments.
children
Children of the uitree object, which are the added uitreenode objects.
Real vector.
deletefcn
Function triggered when the uitree object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uitree is enabled; default value is 'on'.
'on' (default) | 'off'
expand
Indicates if uitree is expanded; default value is 'on'.
'on' (default) | 'off'
fontangle
Font angle of the uitree.
'regular' (default) | 'italic'
fontname
Font name of the uitree.
Any available font from the system.
fontsize
Font size of the uitree.
Integer
fontweight
Font weight of the uitree.
'normal' (default) | 'bold'
foregroundcolor
Color of the text displayed in the uitree root.
3-element integral vector or 'transparent'
handle
Handle of the uitree object.
Double
iconpath
Path to the icon to be displayed next to uitree root node.
String
interruptible
Specifies if callback is interruptible. Default option is not to interrupt the callback
'off' (default) | 'on'
keypressfcn
Function triggered when there is a key press event on the uitree object.
Function handle, string or cell specifying function name and arguments.
parent
Handle of the parent object.
Double
position
Location and size of the uitabgroup in the parent.
The location is specified by the upper-left point; size is specified by the width and height.
[left top width height]
style
Style of the uitree object.
'uitree'
tag
User-defined string to tag graphical control objects.
String
text
Text displayed at the root of uitree.
String
tooltipstring
Tooltip string displayed when the mouse moves over the uitree object.
String
type
The type of the uitree object.
'uitree'
uicontextmenu
Handle of the context menu associated with the uitree object.
Double
units
Units of measurement.
'pixels' | 'normalized'
userdata
User-defined matrix data.
Complex, double or matrix
value
User-defined numerical data.
Double
visible
Specifies if uitree is visible.
'on'(default) | 'off'

uitreenode Properties

Property Name
Description/Values
callback
Callback function that is triggered when interacting with the uitreenode object.
Function handle or string.
children
Children of the uitreenode object, which are the added uitreenode objects.
Real vector.
createfcn
Function triggered when the uitreenode object is created.
Function handle, string or cell specifying function name and arguments.
deletefcn
Function triggered when the uitreenode object is deleted.
Function handle, string or cell specifying function name and arguments.
enable
Indicates if uitreenode is enabled.
'on' (default) | 'off'
expand
Indicates if uitreenode is expanded; default value is 'on'.
'on' (default) | 'off'
fontangle
Font angle of the uitreenode.
'regular' (default) | 'italic'
fontname
Font name of the uitreenode.
Any available font from the system.
fontsize
Font size of the uitreenode.
Integer
fontunits
Units of measurement for fontsize.
'pixels' (default) | 'normalized'
fontweight
Font weight of the uitreenode.
'normal' (default) | 'bold'
foregroundcolor
Color of the text displayed in the uitreenode.
3-element integral vector or 'transparent'
handle
Handle of the uitreenode object.
Double
iconpath
Path to the icon to be displayed next to uitreenode object.
String
interruptible
Specifies if callback is interruptible. Default option is not to interrupt the callback
'off' (default) | 'on'
parent
Handle of the parent object.
Double
position
Position of the uitreenode in its parent object.
Integer
style
Style of the uitreenode object.
'uitreenode'
tag
User-defined string to tag graphical control objects.
String
text
Text displayed in the uitreenode.
String
tooltipstring
Tooltip string displayed when the mouse moves over the uitreenode object.
String
type
The type of the uitreenode object.
'uitreenode'
uicontextmenu
Handle of the context menu associated with the uitreenode object.
Double
userdata
User-defined matrix data.
Complex, double or matrix
value
User-defined numerical data.
Double
visible
Shows the visibility of the uitreenode object.
'on'

Hggroup Properties

Property Name
Description/Values
areagroup (area plot only)
A vector of handles, which point to area groups.
autoscale (quiver plot only)
Enables the scaling of the quiver plot vectors.
'on' | 'off'
autoscalefactor (quiver plot only)
The scaling factor of the quiver plot vectors. Default value is 0.9.
Double
basevalue (area plot only)
Base value of the shading.
Double
bargroup (bar chart plot only)
A vector of handles, which point to bar groups.
barlayout (bar chart plot only)
The bar layout style.
'grouped' | 'stacked'
barstyle (bar chart plot only)
The bar style.
Integer in the range [0,4]
barwidth (bar chart plot only)
The width of the bars.
Integer
cdata (2d scatter plot only)
The color of each marker of a scatter plot.
M*3 matrix of RGB
children
The children of the hggroup object.
color (quiver plot only)
Color of the quiver plot vectors.
1*3 matrix of RGB | colorname
dataxoffset
Shifts the data along the x axis.
Double
datayoffset
Shifts the data along the y axis.
Double
datazoffset
Shifts the data along the z axis.
Double
dataxscale
Scales the data in the x axis.
Double
datayscale
Scales the data in the y axis.
Double
datazscale
Scales the data in the z axis.
Double
displayname
The group's named.
String
facecolor
The object color.
1*3 matrix of RGB | colorname
handle
The handle of the hggroup object.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
imgrid (imagesc plot only)
Visibility of the image grid.
'off' | 'on'
linestyle (quiver plot only)
The vector line style.
'-' | '--' | '-.' | ':' | '-:' | 'none'
linewidth (quiver plot only)
The vector line width.
Integer
marker (scatter and quiver plot only)
marker style
's' | 'square' | '^' | 'v' | 'x' | 'o' | 'd' | 'diamond' | '+' | '*' | '.' | 'none'
markerfacealpha (scatter plot only)
The marker color opacity.
Double
markerfacecolor (scatter and quiver plot only)
The marker color.
1*3 matrix of RGB | colorname
markersize (scatter and quiver plot only)
Size of the marker.
Integer
maxheadsize (quiver plot only)
The scaling factor of the quiver plot arrow head. Default value is 0.3.
Double
parent
The handle of the parent axes.
0
showarrowhead (quiver plot only)
Sets the arrow head visible.
'on' | 'off'
tag
A tag attached to the hggroup object.
String
type
The type of the hggroup object.
'hggroup'
udata (quiver plot only)
Data values of the vector u component.
vector | matrix
units
The units of measurement, currently not used.
'pixels' | 'normalized'
vdata (quiver plot only)
Data values of the vector v component.
vector | matrix
visible
Visibility of the hggroup object.
'on' | 'off'
xdata
Data values associated with the x axis.
vector | matrix
yaxis(all except bar plot)
Handle of the vertical axis this object is plotted on.
Double
ydata
Data values associated with the y axis.
vector | matrix
zdata
Data values associated with the z axis (3D bar or scatter only).
vector | matrix

Patch Properties

Property Name
Description/Values
cdata (3d patch plot only)
A scalar value per vertex or face, or an 1xNx3(rgb) matrix defining the color of each face.
matrix
children
The children of the patch object.
color (triplot only)
Color of triplot line.
1*3 matrix of RGB | colorname
dataxoffset
Shifts the data along the x axis.
Double
datayoffset
Shifts the data along the y axis.
Double
datazoffset
Shifts the data along the z axis.
Double
dataxscale
Scales the data in the x axis.
Double
datayscale
Scales the data in the y axis.
Double
datazscale
Scales the data in the z axis.
Double
displayname
The patch's named.
String
edgecolor (trimesh only)
The color of the trimesh edges.
1*3 matrix of RGB | colorname | 'interp' | 'flat'
facecolor (all except triplot and trimesh)
The color of the patch.
1*3 matrix of RGB | colorname | 'interp' | 'flat'
handle
The handle of the patch object.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
linestyle (triplot only)
The triplot line style.
'-' | '--' | '-.' | ':' | '-:' | 'none'
linewidth (triplot only)
The triplot line width.
Integer
marker (triplot only)
Marker style
's' | 'square' | '^' | 'v' | 'x' | 'o' | 'd' | 'diamond' | '+' | '*' | '.' | 'none'
markerfacecolor (triplot only)
The marker color.
1*3 matrix of RGB | colorname
markersize (triplot only)
Size of the marker.
Integer
parent
The handle of the parent axes.
0
tag
A tag attached to the patch object.
String
type
The type of the patch object.
'patch'
units
The units of measurement, currently not used.
'pixels' | 'normalized'
visible
Visibility of the patch object.
'on' | 'off'
xdata
Data values associated with the x axis.
vector | matrix
yaxis(2d patch and triplot plot)
Handle of the vertical axis this object is plotted on.
Double
ydata
Data values associated with the y axis.
vector | matrix
zdata
Data values associated with the z axis (3D patch only).
vector | matrix

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.
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
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]
tag
A tag attached to the image object.
String
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
handlevisibility
If set to 'off' then this object is not listed in its parent 'children' value.
'on' | 'off'
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'

Colorbar Properties

Property Name
Description/Values
children
Children of the colobar object; an empty matrix for now.
clim
Range of the colorbar.
2-element vector
colorbarscale
Scale of the colorbar values.
'linear' | 'log' | 'db10' | 'db20'
colorlevels
The colorbar values.
Note: The set command for this property accepts either an integer or a real vector. Use a real vector to set custom values to the colorbar. Use an integer to define the number of colors in the colorbar. In this case, the range and values of the colorbar are automatically calculated.
Integer or real vector.
colormap
The color map of the plot.
matrix
fontname
The font name of the colorbar tick labels.
Any available font from the system.
fontsize
The font size of the colorbar tick labels.
Integer
handle
Handle of the colorbar object.
Double
location
Location of the colorbar.
'northeast' | 'northwest' | 'southeast' | 'southwest'
numericformat
The format of the colorbar tick labels.
'scientific' | 'fixed'
numericprecision
The precision of the colorbar tick labels.
Integer
parent
Handle of the parent axes object.
Double
tag
A tag attached to the colorbar object.
String
type
Object type.
'colorbar'
units
Units of measurement (currently not used).
'pixels' | 'normalized'
visible
Colorbar visibility.
'on' | 'off'

Legend Properties

Property Name
Description/Values
bordercolor
Legend border color.
1*3 matrix of RGB | colorname
borderwidth
Legend border width.
Integer
box
Background box visibility.
'on' | 'off'
children
Children of the legend object; an empty matrix for now.
fontangle (2D plots only)
The font angle of the legend tick labels.
'regular' | 'italic'
fontname
The font name of the legend tick labels.
Any available font in the system.
fontsize
The font size of the legend tick labels.
Integer
fontweight (2D plots only)
The font weight of the legend tick labels.
'normal' | 'bold'
handle
Handle of the legend object.
Double
location
Location of the legend. Refer to the legend documentation page for valid options.
String | 2-element vector
parent
Handle of the parent axes object.
Double
tag
A tag attached to the legend object.
String
type
Object type.
'legend'
units
Units of measurement (currently not used).
'pixels' | 'normalized'
visible
Legend visibility.
'on' | 'off'

Waitbar Properties

Property Name
Description/Values
handle
Handle of the waitbar.
height
Height of the waitbar in pixels.
message
Message displayed in the waitbar.
title
Title of the waitbar.
Value
Fractional value of the progress of the waitbar.
visible
1 if waitbar is visible and 0 if waitbar is hidden.
width
Width of the waitbar in pixels.