Destroy object action (dictionary item)
For automation interface information about a Destroy Object Action, click here Destroy object action (dictionary item). For automation interface purposes, a Destroy Object Action is an Action Node that has its Node Type set to Destroy Object Action.
A Destroy Object Action is an action that destroys objects. This action destroys the object on its input pin at runtime. The object may be a link object, in which case the semantics of Destroy Link Action also applies.
Create a Destroy Object Action through a Modeler explorer pane or an Activity Diagram:
In a Modeler pane, right-click an Activity or Structured Activity Node, and select New > Action Node > Destroy Object Action.
On an Activity Diagram: click the Destroy Object Action button, and then click in free space or inside an Activity Partition, Interruptible Activity Region or Structured Activity Node.
To access the Destroy Object Action button, click the arrow next to the Read Self Action button and then click Destroy Object Action.
On creation of a Destroy Object Action, Modeler creates an Input Pin named Target Pin. You cannot delete this Input Pin, and you cannot create any other Input Pins or Output Pins on a Destroy Object Action.
When used on an Activity Diagram, a Destroy Object Action's notation is as follows.
The View Options on an Activity Diagram allow you to show or hide the Name, Action Type and Linked Item Name (not applicable). By default, the Action Type is shown. The view options are set through the Action Node entry. See Action node view options - activity diagram.
On an Activity Diagram, you can populate a Destroy Object Action's missing Activity Flows, Output Pins, Comments and Constraints: right-click the Destroy Object Action, point to Populate, and then click the appropriate command.
In the Dictionary pane, Destroy Object Actions are listed in the UML\Action Nodes folder.
In the Modeler panes, a short-cut symbol on the Destroy Object Action's icon indicates that the item is a stub.
The following sections provide information about how a Destroy Object Action is used in the model.
Properties
In addition to the standard properties a Destroy Object Action has these properties:
Owned by
Activity — The Activity that scopes the Destroy Object Action.
Structured Activity Node — Applies only when the Destroy Object Action is scoped directly to a Structured Activity Node.
Owns
Control Flow — The Control Flow is owned jointly by the Destroy Object Action and the associated item. The access permissions you have to a Control Flow are determined by the access permissions you have to its source item.
Dependency — The Dependency is owned jointly by the Destroy Object Action and the other associated item. The access permissions you have to a Dependency are determined by the access permissions of the dependent item.
Exception Handler — The Exception Handler is owned jointly by the Destroy Object Action and the associated item. The access permissions you have to an Exception Handler are determined by the access permissions you have to its source item.
Input Pin — Only the Target Pin that Modeler creates on creation of the Destroy Object Action.
IO Flow — The IO Flow is owned jointly by the Destroy Object Action, the IO Flow's other linked item and the IO Flow's IO Item.
Defined in these parts of the model
Shown on these diagrams
Can be linked to these dictionary items
In addition to the owning Activity or Structured Activity Node, a Destroy Object Action can be linked to the following items.
Stereotype — To make a Destroy Object Action valid for a Stereotype, set up Action Node a valid item type.
* 
Like most other items in a Model, a Destroy Object Action can be linked to an Activity Partition, Comment, Frame Box, General Node, General Flow, General Flow Diagram Node, Constraint (applied), General Flow Diagram Flow or Swimlane.