When you create a composite part, you might want some features of parts embedded within it to appear in the interface of the composite part. For example, suppose you create a composite part named ButtonSet containing a set of push buttons that you want to reuse. When you add the ButtonSet composite part to another composite, you want to be able to connect to each of the push buttons.
When you first create a composite part, its interface reflects its inheritance, not the features of the parts embedded within it. To expose features of the embedded parts, you must promote them to the composite's interface.
Alternatively, you can promote the this attribute of an embedded part to add the entire part as an attribute of the composite part. Then, when you use the composite part in another composite part, you can tear off the attribute as a Variable part and connect to features of the embedded part represented by the Variable.
About Defining Part
Interfaces
Default Promoted Feature Names
About Tearing Off
Attributes
Defining Part Interfaces for
Visual Composition
When you promote a part feature, you can use a default composite part feature name produced by VisualAge. The default feature name is a combination of the name of the part you are promoting the feature from and the name of the feature you are promoting. This identifies the part that implements the feature, which is helpful if the composite part contains more than one part with the same feature. Then, when you connect to the feature, you can tell which embedded part it belongs to.
For example, if you promote the buttonClickEvent feature for a part named PushButton2, the default composite part feature name is pushButton2ButtonClickEvent.
