Copyright ©1995 by NeXT Computer, Inc.  All Rights Reserved.

DBCustomAssociation (informal protocol)

	Category Of:	Object
	Declared In:	dbkit/DBAssociation.h

Category Description

Where an application uses a custom subclass of DBAssociation to record the link between a data source (such as a DBRecordList or the contents of a DBBinder), the object in the user interface that displays the associated data should implement methods from this informal protocol.  They correspond to instance methods in DBAssociation.

Method Types

Access to the associated value

association:setValue:

association:getValue:

Notifications to the associated display

associationContentsDidChange:

associationSelectionDidChange: associationCurrentRecordDidDelete:

Instance Methods

association:getValue:

association:association getValue:(DBValue *)value

Gets the value of the associated destination, and copies it to value. Returns self. See also:  getValue: (DBAssociation class)

association:setValue:

association:association setValue:(DBValue *)value

Causes the destination to display value. Returns self. See also:  setValue: (DBAssociation class)

associationContentsDidChange:

associationContentsDidChange:association

Notification that there has been a change to the data values in a portion of the DBFetchGroup's DBRecordList, necessitating a corresponding change in the user interface object.

associationCurrentRecordDidDelete:

associationCurrentRecordDidDelete:association

Notification that the current record has been deleted from the DBFetchGroup's DBRecordList, necessitating a corresponding change in the user interface object.

associationSelectionDidChange:

associationSelectionDidChange:association

Notification that there has been some sort of change in the current record of the DBFetchGroup. The change could be to change the selection to a different row, or to add a selection, or to deselect an existing section so that no row is selected. Usually the change is produced by something the user did.