(informal protocol)
| Adopted by | |
| Framework | /System/Library/Frameworks/AppKit.framework |
| Availability | Available in Mac OS X v10.3 and later. |
| Companion guide | |
| Declared in | NSKeyValueBinding.h |
The NSEditor informal protocol is implemented by controllers and user interface elements. It provides a means for requesting that the receiver commit or discard any pending edits.
These methods are typically invoked on user interface elements by a controller. They can also be sent to a controller in response to a user’s attempt to save a document or quit an application.
NSController provides an implementation of this protocol, as do the Application Kit user interface elements that support binding.
– discardEditing required method
– commitEditing required method
– commitEditingWithDelegate:didCommitSelector:contextInfo: required method
Returns whether the receiver was able to commit any pending edits. (required)
- (BOOL)commitEditing
Returns YES if the changes were successfully applied to the model, NO otherwise. A commit is denied if the receiver fails to apply the changes to the model object, perhaps due to a validation error.
NSKeyValueBinding.hAttempt to commit any currently edited results of the receiver. (required)
- (void)commitEditingWithDelegate:(id)delegate didCommitSelector:(SEL)didCommitSelector contextInfo:(void *)contextInfo
The receiver must have been registered as the editor of an object using objectDidBeginEditing:, and has not yet been unregistered by a subsequent invocation of objectDidEndEditing:. When the committing has either succeeded or failed, send the following message to the specified object. The didCommitSelector method must have the following method signature:
- (void)editor:(id)editor didCommit:(BOOL)didCommit contextInfo:(void *)contextInfo |
If an error occurs while attempting to commit, for example if key-value coding validation fails, an implementation of this method should typically send the NSView in which editing is being done a presentError:modalForWindow:delegate:didRecoverSelector:contextInfo: message, specifying the view's containing window.
NSKeyValueBinding.hCauses the receiver to discard any changes, restoring the previous values. (required)
- (void)discardEditing
NSKeyValueBinding.h
Last updated: 2006-05-23
