(informal protocol)
Declared in:
- EOInterface/EODisplayGroup.h
The EODisplayGroup Delegate informal protocol defines methods that an EODisplayGroup can invoke in its delegate. Delegates are not required to provide implementations for all of the methods in the informal protocol. Instead, declare and implement any subset of the methods declared in the informal protocol that you need, and use the EODisplayGroup method setDelegate: method to assign your object as the delegate. A display group can determine if the delegate doesn't implement a delegate method and only attempts to invoke the methods the delegate actually implements.
- Fetching objects
- - displayGroupShouldFetch:
- - displayGroup:didFetchObjects:
- - displayGroup:shouldRefetchForInvalidatedAllObjectsNotification:
- Inserting, updating, and deleting objects
- - displayGroup:shouldInsertObject:atIndex:
- - displayGroup:didInsertObject:
- - displayGroup:createObjectFailedForDataSource:
- - displayGroup:didSetValue:forObject:key:
- - displayGroup:shouldDeleteObject:
- - displayGroup:didDeleteObject:
- Managing the display
- - displayGroup:shouldDisplayAlertWithTitle:message:
- - displayGroup:shouldRedisplayForChangesInEditingContext:
- - displayGroup:displayArrayForObjects:
- Managing the selection
- - displayGroup:shouldChangeSelectionToIndexes:
- - displayGroupDidChangeSelection:
- - displayGroupDidChangeSelectedObjects:
- Changing the data source
- - displayGroupDidChangeDataSource:
- (void)displayGroup:(EODisplayGroup
*)aDisplayGroup
createObjectFailedForDataSource:(EODataSource
*)aDataSource
- (void)displayGroupDidChangeDataSource:(EODisplayGroup
*)aDisplayGroup
- (void)displayGroupDidChangeSelectedObjects:(EODisplayGroup
*)aDisplayGroup
- (void)displayGroupDidChangeSelection:(EODisplayGroup
*)aDisplayGroup
- (void)displayGroup:(EODisplayGroup
*)aDisplayGroup
didDeleteObject:(id)anObject
- (void)displayGroup:(EODisplayGroup
*)aDisplayGroup
didFetchObjects:(NSArray *)objects
- (void)displayGroup:(EODisplayGroup
*)aDisplayGroup
didInsertObject:(id)anObject
- (void)displayGroup:(EODisplayGroup
*)aDisplayGroup
didSetValue:(id)value
forObject:(id)anObject
key:(NSString *)key
- (NSArray *)displayGroup:(EODisplayGroup
*)aDisplayGroup
displayArrayForObjects:(NSArray
*)objects
If the delegate doesn't implement this method, the EODisplayGroup uses its own qualifier and sort ordering to update its displayed objects array.
See Also: - sortOrderings, - qualifier, - displayedObjects
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldChangeSelectionToIndexes:(NSArray
*)newIndexes
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldDeleteObject:(id)anObject
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldDisplayAlertWithTitle:(NSString
*)title
message:(NSString *)message
- (BOOL)displayGroupShouldFetch:(EODisplayGroup
*)aDisplayGroup
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldInsertObject:(id)anObject
atIndex:(unsigned int)anIndex
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldRedisplayForEditingContextChangeNotification:(NSNotification
*)aNotification
EOObjectsChangedInEditingContextNotification
,
this method allows the delegate to suppress redisplay based on the
nature of the change that has occurred. If the delegate returns YES, aDisplayGroup redisplays;
if it returns NO, aDisplayGroup doesn't. aNotification supplies
the EOEditingContext that has changed, as well as which objects
have changed and how. See the EOEditingContext class specification
for information on EOObjectsChangedInEditingContextNotification
.
See Also: - redisplay
- (BOOL)displayGroup:(EODisplayGroup
*)aDisplayGroup
shouldRefetchForInvalidatedAllObjectsNotification:(NSNotification
*)aNotification
EOInvalidatedAllObjectsInStoreNotification
,
this method allows the delegate to suppress refetching of the invalidated
objects. If the delegate returns YES, aDisplayGroup immediately
refetches its objects. If the delegate returns NO, aDisplayGroup doesn't immediately
fetch, instead delaying until absolutely necessary. aNotification is
an NSNotification. See the EOObjectStore and EOEditingContext class
specifications for information on this notification.