Specify Labels in States and Transitions Programmatically

When using the Stateflow^® API, specify the labels of states and transitions by assigning a character vector to the LabelString property.

To extract parts of the state or transition label, use the properties of the Stateflow.State and Stateflow.Transition objects listed in this table.

API Object	Property	Description
`Stateflow.State`	`DuringAction`	Text in the `during` action in this state. This property is not supported in Moore charts.
	`EntryAction`	Text in the `entry` action in this state. This property is not supported in Moore charts.
	`ExitAction`	Text in the `exit` action in this state. This property is not supported in Moore charts.
	`MooreAction`	Text in the action in this state. This property is supported only in Moore charts. For more information, see Design Guidelines for Moore Charts.
	`Name`	Name of this state.
	`OnAction`	Text in the `on` actions in this state, parsed as a cell array of this form: {'trigger1','action1',...,'triggerN','actionN'} This property is not supported in Moore charts.
`Stateflow.Transition`	`Condition`	Text in the condition on this transition.
	`ConditionAction`	Text in the condition action on this transition.
	`TransitionAction`	Text in the transition action on this transition.
	`Trigger`	Text in the trigger on this transition.

With the exception of Name, all of these properties are read-only. For more information on the syntax for state and transition labels, see Define Actions in a State and Define Actions in a Transition.

Enter Labels on Transitions

Suppose that tr is the Stateflow.Transition object that corresponds to a transition. You can assign a label that specifies a trigger, condition, and condition action on this transition by entering:

tr.LabelString = "trigger[guard]{action();}";

Transition with a trigger, a condition, and a condition action.

To extract the trigger, condition, and condition action specified by the transition label, enter:

trigger = tr.Trigger

trigger =

    'trigger'

cond = tr.Condition

cond =

    'guard'

action = tr.ConditionAction

action =

    'action();'

Enter Multiline Labels in States

There are two equivalent ways to enter multiline labels for states and transitions. For example, Suppose that sA is a Stateflow.State object that corresponds to a state. To enter a multiline label with entry and during actions, you can:

Call the MATLAB^® function sprintf and use the escape sequence \n to insert newline characters:
```
str = sprintf("A\nen: action1();\ndu: action2();\nen,du: action3();");
sA.LabelString = str;
```

Enter a concatenated text expression that uses the function newline to create newline characters:

str = "A" + newline + ...
    "en: action1();" + newline + ...
    "du: action2();" + newline + ...
    "en,du: action3();"
sA.LabelString = str;

State with entry and during actions.

To extract the state name, entry action, and during action specified by the state label, enter:

name = sA.Name

name =

    'A'

entry = sA.EntryAction

entry =

    ' action1();
      action3();'

during = sA.DuringAction

during =

    ' action2();
      action3();'