previous chapter contents page top page next chapter


TargetedAnnouncement

February 29, 1996

inherits from Announcement

Class Description

Class TargetedAnnouncement is a subclass of Announcement that allows you to associate an announcement with a target object. The target is usually an object that represents some hardware resource available to Magic Cap.

Programming information

Instantiate: rarely
Subclass: rarely
Call its methods: never

You might instantiate objects of this class if you wanted to create your own announcements associated with target objects, and you might create subclasses if you wanted to specialize the behavior of the announcement for a particular kind of target object.

Methods defined by class TargetedAnnouncement

Class TargetedAnnouncement defines the following methods:

Method Description
Notice Overridden to retract the announcement when target is destroyed
RetractWithoutHiding Overridden to make target nil before retracting announcement
SetTarget Indicate object to be associated with this announcement
Target Get object that is associated with this announcement

Fields defined by class TargetedAnnouncement

Class TargetedAnnouncement defines the following fields:

Field Type Description
Inherited from Announcement
global bootlist DataList List of announcements retracted or announced at boot
Flags Flags Announcement flags
info HasText Text of the announcement
stamp Viewable The small stamp displayed in the name bar
sound Sound Sound played when the announcement is made
publicAddress Object The public address to use for the announcement
Defined by TargetedAnnouncement
target Object Object associated with this announcement

Method Descriptions

Notice

overrides Notice

Call: rarely
Override: sometimes

Class TargetedAnnouncement overrides Notice to make the announcement retract when its associated object no longer exists.

RetractWithoutHiding

overrides RetractWithoutHiding

Call: rarely
Override: sometimes

Class TargetedAnnouncement overrides RetractWithoutHiding to set the announcement's target to nilObject before it retracts itself.

Target

attribute Target: Object
  // operation Target(): Object
  // operation SetTarget(newTarget)

Call: rarely
Override: sometimes