Go to Glossary Search VisualAge C++ Help Go to VisualAge C++ Help Home Page Go to WWW VisualAge C++ Site

Event

Use the Event tab to define the events that you use to notify this or other parts about changes you decide are significant. For example, you might notify other parts when an attribute is set to a certain value or when the user clicks a push button or opens a window.

The Event tab lists all events defined by a part. This tab does not list events that are inherited from the base part. This tab also does not list promoted events that are defined by embedded parts. Promoted events are listed on the Promote tab.

An event notifies observers that something has happened to a part. The event identification specifies what event has occurred. An event parameter can be used to pass information.

To use an event, make a connection from the event name to the target that is to be notified. When you generate code, the event identification is used to inform the connection target that the event occurred. If the event has a parameter, it is passed in event data.

Use the following fields to specify an event:


Related concepts
Connections

Related procedures
Adding Event Features

Related references
Push Buttons -- Part Interface Editor
Part Interface Editor
Visual Composition Messages

Event Name

Use the Event name field to specify a descriptive name for an event. This name appears on the connection menu when you make connections from the event in the Composition Editor.

The event name can contain only single-byte alphanumeric characters and blanks. Each event name within a part must be unique.

You cannot change the event name directly. To rename an event, do the following:

  1. Add a new event that is identical except for the name.
  2. Delete the old event.

Event Parameter Type

Use the Event parameter type field to specify the class or data type of an event parameter, if you need one. The event parameter is passed with the event as event data.

Event notification can provide additional information about the event by passing a parameter. For example, if an event is signalled when the user selects a button that represents a calculator key, it is useful to send the key value as a parameter.