Simulink.Annotation

Specify properties of model annotation

Description

Instances of this class specify the properties of annotations. You can use getCallbackAnnotation in an annotation callback function to get the Simulink.Annotation instance for the annotation associated with the callback function. You can use find_system and get_param to get the Simulink.Annotation instance associated with any annotation in a model. For example, this code gets the annotation object for the first annotation in the currently selected model and turns on its drop shadow

ah = find_system(gcs,'FindAll','on','type','annotation');
ao = get_param(ah(1),'Object');
ao.DropShadow = 'on';

Children

None.

Property Summary

PropertyDescriptionValues
AnnotationType

Type of annotation—text (note), area, or image. This property is read only.

note_annotation | area_annotation | image_annotation

BackgroundColor

Background color of this annotation.

RGB value array | [r,g,b,a] where r, g, b, and a are the red, green, blue, and alpha values of the color normalized to the range 0.0 to 1.0, delineated with commas. The alpha value is optional and ignored.

Annotation background color can also be 'automatic' (transparent), 'black', 'white', 'red', 'green', 'blue', 'cyan', 'magenta', 'yellow', 'gray', 'lightBlue', 'orange', 'darkGreen'.

ClickFcn

Specifies MATLAB® code to execute when you click this annotation. See Associate a Click Function with an Annotation for more information.

character vector

DeleteFcnMATLAB code to execute before deleting this annotation. See Annotation Callback Functions.

character vector

Description

Description of this annotation.

character vector

DropShadow

Turn drop shadow display on or off.

'on' | {'off'}

FixedHeight

Specify whether the bottom border of the annotation resizes as you add content.

'on' | {'off'}, where 'off' means that the bottom border resizes as you add content

FixedWidth

Specify whether to use word wrap or to have the width of the annotation expand to accommodate text.

'on' | {'off'}, where 'off' means to use word wrap

FontAngle (plain text only)

Angle of the annotation font. The default value, 'auto', uses of the default font angle specified for lines in the Font Styles dialog box.

'normal' | 'italic' | 'oblique' | {'auto'}

FontName (plain text only)

Name of annotation font. The default value, 'auto', uses the default font specified for lines in the Font Styles dialog box.

character vector

FontSize (plain text only)

Size of annotation font in points. The default value, -1, uses the default text size for lines specified in the Font Styles dialog box.

decimal number | {'-1'}

FontWeight (plain text only)

Weight of the annotation font. The default value, 'auto', use of the default weight for lines specified in the Font Styles dialog box.

'light' | 'normal' | 'demi' | 'bold' | {'auto'}

ForegroundColor

Foreground color of this annotation.

RGB value array | [r,g,b,a] where r, g, b, and a are the red, green, blue, and alpha values of the color normalized to the range 0.0 to 1.0, delineated with commas. The alpha value is optional and ignored.

Annotation foreground color can also be 'black', 'white', 'red', 'green', 'blue', 'cyan', 'magenta', 'yellow', 'gray', 'lightBlue', 'orange', 'darkGreen'.

Handle

Annotation handle.

real

HiliteAncestors

For internal use.

 
HorizontalAlignment

Horizontal alignment of this annotation.

'center' | {'left'}|'right'

Interpreter

Specifies whether the annotation is interpreted as rich text or contains LaTeX commands. The default value, 'off', specifies a plain text annotation. When you format a plain text annotation using the formatting toolbar, the annotation becomes a rich text annotation.

'rich' | 'tex' | {'off'}

IsImage

Specifies whether the annotation is an image-only annotation.

'on' | {'off'}

InternalMargins

Space from the bounding box of text to the borders of the annotation.

1x4 array [left top right bottom]. The default is [1 1 1 1].

Supported coordinates are between -1073740824 and 1073740823, inclusive.

LoadFcn

MATLAB code to execute when the model containing this annotation is loaded. See Annotation Callback Functions.

character vector

Name

Text of annotation. Same as Text.

character vector

Parent

Parent name of annotation object.

character vector

Path

Path to the annotation.

character vector

PlainText

Read-only display of the text in the annotation, without formatting.

vector

Position

Location of the annotation.

vector of coordinates, in pixels: [left top right bottom]

The origin is the upper-left corner of the Simulink® Editor canvas before any canvas resizing. Supported coordinates are between -1073740824 and 1073740823, inclusive. Positive values are to the right of and down from the origin. Negative values are to the left of and up from the origin.

RequirementInfo

For internal use.

character vector

Selected

Specifies whether this annotation is currently selected.

'on' | 'off'

Tag

Text to assign to the annotation Tag parameter and save with the annotation.

character vector

TeXMode

Specifies whether to render TeX markup.

'on' | {'off'}

Text

Text of annotation. Same as Name.

character vector

Type

Annotation type. This is always 'annotation'.

'annotation'

UseDisplayTextAsClickCallback

Specifies whether to use the contents of the Text property as the click function for this annotation.

If set to 'on', the text of the annotation is interpreted as a valid MATLAB expression and run. If set to 'off', clicking the annotation runs the click function, if there is one. If there is no click function, clicking the annotation has no effect.

See Associate a Click Function with an Annotation for more information.

'on' | {'off'}

UserData

Any data that you want to associate with this annotation.

vector

VerticalAlignment

Vertical alignment of this annotation.

'middle' | {'top'}|'cap'|'baseline'|'bottom'

Method Summary

Method

Description

delete

Delete this annotation from the Simulink model.

dialog

Display the Annotation properties dialog box.

disp

Display the property names and their settings for this Annotation object.

fitToView

Zoom in on this annotation and highlight it in the model.

get

Return the specified property settings for this annotation.

help

Display a list of properties for this Annotation object with short descriptions.

methods

Display all nonglobal methods of this Annotation object.

set

Set the specified property of this Annotation object with the specified value.

setImage

Set the annotation contents to the specified image file. The resulting annotation is an image-only annotation.

struct

Return and display a MATLAB structure containing the property settings of this Annotation object.

view

Display this annotation in the Simulink Editor with this annotation highlighted.

Introduced before R2006a