For automation interface information about a History State, see
State (automation interface). For automation interface purposes, a History State is a State that has its UML State Type set to History.
A History State applies to the state region that contains it, and it identifies the default previous state if the region has never been entered. A History State represents deep or shallow history:
• Deep History represents the most recent active configuration of the composite state that directly contains the History State.
• Shallow History represents the most recent active substate of its containing state.
Create a History State through a Modeler explorer pane or a State Diagram:
• In a Modeler pane, right-click a State Machine or Sequential State, point to New, point to Pseudo State, and then click History State.
• On a State Diagram, click the History State toolbar button, and then click the diagram background (within the frame) or within a Sequential State.
If you want a History State to represent deep history: on the Options tab of the History State's property pages, select the Deep History check box.
When used on a State Diagram, a History State's notation is as follows.
On a State Diagram, you can populate History States: right-click the State Machine (frame) or Sequential State that owns the History States, point to Populate, and then click All States. Note that all owned states are added to the diagram.
In the Dictionary pane, History States are listed in the UML\States folder.
In the Modeler panes, a short-cut symbol on the History State's icon indicates that the item is a
stub.
The following sections provide information about how a History State is used in the model.
Properties
In addition to the standard properties a History State has these properties:
• Deep History (Is Deep History through the automation interface)
Dependency —The Dependency is owned jointly by the History State and the other associated item. The access permissions you have to a Dependency are determined by the access permissions of the dependent item.
Transition —The Transition is owned jointly by the History State and the other associated item. The access permissions you have to a Transition are determined by the access permissions of the source item.
History State toolbar button, and then click the diagram background (within the frame) or within a Sequential State.
on the History State's icon indicates that the item is a
stub.
Atomic State (through child State Diagram)
Dependency —The Dependency is owned jointly by the History State and the other associated item. The access permissions you have to a Dependency are determined by the access permissions of the dependent item.
Transition —The Transition is owned jointly by the History State and the other associated item. The access permissions you have to a Transition are determined by the access permissions of the source item.
Stereotype —To make a History State valid for a Stereotype, make State a valid item type.
Sequential State
State Machine
Comment
Constraint
State Model
State Diagram
Variant Diagram