qstyle(H,S,...)
H
[ numeric ] - Handle to a figure or axes object that will be styled together with its descandants (unless 'cascade='
is false).
S
[ struct ] - Struct each field of which refers to an object-dot-property; the value of the field will be applied to the the respective property of the respective object; see below the list of graphics objects allowed.
'cascade='
[ true
| false
] - Cascade through all descendants of the object H
; if false only the object H
itself will be styled.
'warning='
[ true
| false
] - Display warnings produced by this function.
The style structure, S
, is constructed of any number of nested object-property fields:
S.object.property = value;
The following is the list of standard Matlab grahics objects the top-level fields can refer to:
figure
axes
title
xlabel
ylabel
zlabel
line
bar
patch
text
In addition to standard Matlab graphics object names, you can also refer to the following special instances of objects created by IRIS functions:
rhsaxes
(an RHS axes object created by plotyy
)legend
(represented by an axes object);plotpred
(line objects with prediction data created by plotpred
);highlight
(a patch object created by highlight
);highlightcaption
(a text object created by highlight
);vline
(a patch object created by vline
);vlinecaption
(a text object created by vline
);zeroline
(a line object created by zeroline
).The property used as the second-level field is simply any regular Matlab property of the respective object (see Matlab help on graphics).
The value assigned to a particular property can be either of the following:
a single proper valid value (i.e. a value you would be able to assign using the standard Matlab set
function);
a cell array of multiple different values that will be assigned to the objects of the same type in order of their creation;
a text string starting with a double exclamation point, !!
, followed by Matlab commands. The commands are expected to eventually create a variable named SET
whose value will then assigned to the respective property. The commands have access to variable H
, a handle to the current object.
Font size (in objects like axes, title, etc.) can be set to either a numeric scalar (which is the default Matlab behavior) or a character string describing a numerical value followed by a percent sign, such as '150%'
. In that case, the font size will be set to the corresponding percentage of the current size.