Documentation Archive Developer
Search
PATH Documentation > WebObjects

Table of Contents

EOMasterCopyAssociation


Inherits from:
EOMasterAssociation : EOAssociation : EODelayedObserver (EOControl) : Object
Implements:
NSDisposable
EOObserving (EOControl)
Package:
com.webobjects.eointerface


Class Description


An EOMasterCopyAssociation object synchronizes two EODisplayGroups that share the same data source but have different qualifiers.

By binding two display groups with an EOMasterCopyAssociation, any changes performed in one display group are immediately reflected in the other. Similarly, changing the selection in one display group immediately changes it in the other one.


Usable With
EODisplayGroup


Aspects
parent An EODisplayGroup with which the association's display group should be synchronized.


Object Keys Taken
None  


Examples

Suppose you have an EODisplayGroup for displaying Talent objects (actors and directors) and another display group for displaying the pictures of the Talents who are actors. When a Talent is selected in the first display group, you want the "actor" display group to select that Talent's picture if the selected Talent is an actor. Since both display groups manage Talent objects, they can share the same EODataSource. However, the first display group is unqualified-it fetches all Talent objects; the second display group is qualified to fetch only the Talents who are actors.

To do this, in Interface Builder, start with an unqualified display group for displaying all the Talents. Drag a second display group from the Enterprise Objects palette into your nib. Control-drag a connection from the new display group to the unqualified Talent display group. In the Connections inspector, choose EOMasterCopyAssociation, select the parent aspect, and click Connect. This action automatically sets the second display group's data source. Initially, the data source is set to an EODetailDataSource-that's what you'll see in Interface Builder. However, at runtime, the association switches the second display group's data source to that of the parent display group.

Now when you run the application, the display groups will be synchronized with one another. (You'll programmatically assign a qualifier to the second display group so that it filters out non-actor Talents.)




Interfaces Implemented


NSDisposable
EOObserving


Method Types


All methods
EOMasterCopyAssociation
subjectChanged


Constructors



EOMasterCopyAssociation

public EOMasterCopyAssociation(Object aDisplayObject)

Creates a new EOMasterCopyAssociation to monitor and update the value in aDisplayObject, an EODisplayGroup.

You normally set up associations with the Interface Builder application, in which case you don't need to create them programmatically. However, if you do create them up programmatically, setting them up is a multi-step process. After creating an association, you must bind its aspects and establish its connections.

See Also: bindAspect (EOAssociation), establishConnection (EOAssociation)




Instance Methods



subjectChanged

public void subjectChanged()

Description forthcoming.

© 2001 Apple Computer, Inc. (Last Published April 21, 2001)


Table of Contents