IRIS Toolbox Reference Manual

## qstyle

Apply styles to graphics object and its descandants

#### Syntax

    qstyle(H,S,...)

#### Input arguments

- `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.

#### Options

- `'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.

#### Description

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, 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 line 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.

#### Example

IRIS Toolbox. Copyright © 2007—2013 Jaromir Benes.