NSUserInterfaceValidations Protocol Reference

Framework
/System/Library/Frameworks/AppKit.framework
Availability
Available in OS X v10.0 and later.
Companion guide
Declared in
NSUserInterfaceValidation.h

Overview

The NSUserInterfaceValidations protocol works with the NSValidatedUserInterfaceItem protocol to allow the target of a user interface element such as a menu item or a toolbar item to decide whether or not the user interface element should be enabled.

Your custom classes should adopt this protocol if an instance may be the target of a user interface element and need to conditionally enable or disable the element based on the current state of the instance. For more details, read User Interface Validation.

Tasks

Validating User Interface Items

Instance Methods

validateUserInterfaceItem:

Returns a Boolean value that indicates whether the sender should be enabled. (required)

- (BOOL)validateUserInterfaceItem:(id < NSValidatedUserInterfaceItem >)anItem
Parameters
anItem

The user interface item to validate. You can send anItem the action and tag messages.

Return Value

YES if the user interface item should be enabled, otherwise NO.

Availability
  • Available in OS X v10.0 and later.
Declared In
NSUserInterfaceValidation.h