NSValidatedUserInterfaceItem 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 NSValidatedUserInterfaceItem protocol works with the NSUserInterfaceValidations protocol to enable or disable a control automatically, depending on whether any responder in the responder chain can handle the control’s action method. The NSMenuItem and NSToolbarItem classes implement this protocol.

By conforming to this protocol, your control can participate in this validation mechanism. To validate a control, the application calls validateUserInterfaceItem: for each item in the responder chain, starting with the first responder. If no responder returns YES, the item is disabled. For example, a menu item that sends the copy: action message would disable itself if no responder in the responder chain can be copied.

Tasks

Getting Information About a User Interface Item

Instance Methods

action

Returns the selector of the receiver’s action method. (required)

- (SEL)action
Return Value

The selector of the receiver's action method.

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

tag

Returns the receiver’s tag integer. (required)

- (NSInteger)tag
Return Value

The receiver's tag.

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