# Activity region

There are two kind of regions : expansion region and interruptible region, both may be placed under an activity or a region.

In the browser an expansion region may contain sub activity regions, expansion nodes and activity nodes (activity action, object node or control node)

In the browser an interruptible region may contain sub activity regions and activity nodes (activity action, object node or control node)

The region's properties are exposed below.

## Expansion region menus

The expansion region menu appearing with a right mouse click on its representation in the browser is something like these, supposing the region not read-only nor deleted (see also menu in a diagram) :

### Menu : add ...

These entries of the menu allow to add an expansion node, a nested region or an activity node (activity action, object node or control node)

### Menu : edit

edit allows to show/modify the region properties. In case the region is read-only, the fields of the dialog are also read-only.

#### Expansion region dialog, tab Uml

The proposed stereotypes are the default one specified through the Default stereotypes dialog more the current one (empty here). It is possible to choose into the list or to give a new one, or to empty it.

The mode and the flag must isolate are the standard UML information.

The editor button visible above and associated here to the description, allows to edit the description in an other window, or to call an external editor (for instance Xcoral) specified through the environment dialog. Note that this external editor have to create an own window, its parameter is the pathname of the file containing the description, its execution is done in parallel with BOUML which looks each second at the file contents to get the new definition until the dialog is closed (I do not like very much this polling but this works even QT isn't compiled with the thread support).

### Menu : duplicate

The menu entry duplicate clone the region without its children

### Menu : set it nested in the region above

The menu entry set it nested in the region above is present when the previous element in the browser is a region, allows to move the region inside

### Menu : extract it from current parent region

The menu entry extract it from current parent region is present when the region is nested in an other one, allows to extract the region and place it in its grand parent..

### Menu : mark

See mark

### Menu : delete

The menu entry delete is only present when the region is not read-only.

Delete the region and all its children, and all the representation of them in the opened diagrams. After that it is possible to undelete them (from the browser) until you close the project : obviously the deleted items are not saved !

### Menu : tool

The menu entry tool is only present in case at least a plug-out may be applied on an expansion region. The selected tool is called and applied on the current region.

## Interruptible region menus

The interruptible region menu appearing with a right mouse click on its representation in the browser is something like these, supposing the region not read-only nor deleted (see also menu in a diagram) :

### Menu : add ...

These entries of the menu allow to add a nested region or an activity node (activity action, object node or control node)

### Menu : edit

edit allows to show/modify the region properties. In case the region is read-only, the fields of the dialog are also read-only.

#### Interruptible region dialog, tab Uml

The proposed stereotypes are the default one specified through the Default stereotypes dialog more the current one (empty here). It is possible to choose into the list or to give a new one, or to empty it.

The editor button visible above and associated here to the description, allows to edit the description in an other window, or to call an external editor (for instance Xcoral) specified through the environment dialog. Note that this external editor have to create an own window, its parameter is the pathname of the file containing the description, its execution is done in parallel with BOUML which looks each second at the file contents to get the new definition until the dialog is closed (I do not like very much this polling but this works even QT isn't compiled with the thread support).

### Menu : duplicate

The menu entry duplicate clone the region without its children

### Menu : set it nested in the region above

The menu entry set it nested in the region above is present when the previous element in the browser is a region, allows to move the region inside

### Menu : extract it from current parent region

The menu entry extract it from current parent region is present when the region is nested in an other one, allows to extract the region and place it in its grand parent..

### Menu : mark

See mark

### Menu : delete

The menu entry delete is only present when the region is not read-only.

Delete the region and all its children, and all the representation of them in the opened diagrams. After that it is possible to undelete them (from the browser) until you close the project : obviously the deleted items are not saved !

### Menu : tool

The menu entry tool is only present in case at least a plug-out may be applied on an interruptible region. The selected tool is called and applied on the current region.

## Expansion node menus

The expansion node menu appearing with a right mouse click on its representation in the browser is something like these, supposing the node not read-only nor deleted (see also menu in a diagram) :

### Menu : edit

edit allows to show/modify the expansion node properties. In case the node is read-only, the fields of the dialog are also read-only.

#### Expansion node dialog, tab Uml

The proposed stereotypes are the default one specified through the Default stereotypes dialog more the current one (empty here). It is possible to choose into the list or to give a new one, or to empty it.

The proposed types are the non class types defined in the first tab of the generation settings, more all the classes defined in the project (with their localization to distinguish synonymous classes). You are not limited to the proposed list, and any form (even invalid for the target language(s)) may be given. The button type: shows a menu proposing :

- if the current type of the expansion node is a class : to select this class in the browser

- if the expansion node is not read-only and if a class is selected in the browser : to set the type to be this class

The multiplicity, ordering, in state, and is control are the standard UML properties.

The editor button visible above and associated here to the description, allows to edit the description in an other window, or to call an external editor (for instance Xcoral) specified through the environment dialog. Note that this external editor have to create an own window, its parameter is the pathname of the file containing the description, its execution is done in parallel with BOUML which looks each second at the file contents to get the new definition until the dialog is closed (I do not like very much this polling but this works even QT isn't compiled with the thread support).

#### Expansion node dialog, tab Ocl

The Ocl tab allows to specify the selection using the Ocl language, but in fact BOUML doesn't check the syntax, this is just a convention.

#### Expansion node dialog, tab C++

This tab allows to specify the selection in C++, but in fact BOUML doesn't check the syntax, this is just a convention.

#### Expansion node dialog, tab Java

This tab allows to specify the selection in Java, but in fact BOUML doesn't check the syntax, this is just a convention.

### Menu : duplicate

The menu entry duplicate clone the expansion node without its children

### Menu : delete

The menu entry delete is only present when the region is not read-only.

Delete the region and all its children, and all the representation of them in the opened diagrams. After that it is possible to undelete them (from the browser) until you close the project : obviously the deleted items are not saved !

### Menu : referenced by

To know who reference the current parameter through flow

### Menu : mark

See mark

### Menu : tool

The menu entry tool is only present in case at least a plug-out may be applied on an interruptible region. The selected tool is called and applied on the current region.

## Default stereotypes

The dialog allowing to set the default stereotypes :

## Expansion region drawing

An expansion region is drawn in a diagram as a dashed rectangle with rounded corners, with the indication of the mode :

A right mouse click on a the region in a diagram calls the following menu (supposing the region editable) :

### Menu : add expansion node

These entries of the menu allow to add an expansion node.

### Menu : edit drawing settings

These drawing settings concerns only the picture for which the menu is called.

A settings valuing default indicates that the setting specified in the upper level (here the diagram) must be followed, obviously this one may also be default ... up to the project level. When you add a region in a diagram, all the settings are set to default.

To specify the fill color.

### Menu : set associated diagram

set associated diagram allows to automatically open the current diagram when a double mouse click is made on the region representation in a diagram or the browser. After that the only way to edit the region is to choose the edit entry in the menu.

### Menu tools :

Appears only when at least one plug-out is associated to the regions. To apply a plug-out on the region.

## Interruptible region drawing

An interruptible activity region is drawn in a diagram as a dashed rectangle with rounded corners :

A right mouse click on a region in a diagram calls the following menu (supposing the region editable) :

### Menu : edit drawing settings

These drawing settings concerns only the picture for which the menu is called.

A settings valuing default indicates that the setting specified in the upper level (here the diagram) must be followed, obviously this one may also be default ... up to the project level. When you add a region in a diagram, all the settings are set to default.

#### To specify the fill color.

### Menu : set associated diagram

set associated diagram allows to automatically open the current diagram when a double mouse click is made on the region representation in a diagram or the browser. After that the only way to edit the region is to choose the edit entry in the menu.

### Menu tools :

Appears only when at least one plug-out is associated to the regions. To apply a plug-out on the region.

## Expansion node drawing

A expansion node is drawn in a diagram as pins :

A right mouse click on as expansion node in a diagram calls the following menu (supposing the node editable) :

### Menu : edit drawing settings

These drawing settings concerns only the picture for which the menu is called.

A settings valuing default indicates that the setting specified in the upper level (here the diagram) must be followed, obviously this one may also be default ... up to the project level. When you add a node in a diagram, all the settings are set to default.

#### To specify the fill color.

### Menu tools :

Appears only when at least one plug-out is associated to the expansion nodes. To apply a plug-out on the node.

Previous : activity

Next : activity action