Adopted by: NSMenuItem
- Conforms to:
- NSObject
- NSCopying
- NSCoding
Declared in:
- AppKit/NSMenuItem.h
The NSMenuItem protocol is being removed from the Application Kit. The NSMenuItem class will solely assume all associated functionality. This change does not affect binary compatibility between different versions of projects, but might cause failures in project builds. To adapt your projects to this change, alter all references to the protocol (for example, "id <NSMenuItem>") to references to the class ("NSMenuItem").
Refer to the NSMenuItem class description, which replaces this.
- Creating a menu item
- - initWithTitle:action:keyEquivalent:
- Enabling a menu item
- - setEnabled:
- - isEnabled
- Setting the target and action
- - setTarget:
- - target
- - setAction:
- - action
- Setting the title
- - setTitle:
- - title
- Setting the tag
- - setTag:
- - tag
- Setting the state
- - setState:
- - state
- Setting the image
- - setImage:
- - image
- - setOnStateImage:
- - onStateImage
- - setOffStateImage:
- - offStateImage
- - setMixedStateImage:
- - mixedStateImage
- Managing submenus
- - setSubmenu:
- - submenu
- - hasSubmenu
- Getting a separator item
- - isSeparatorItem
- - separatorItem
- Setting the owning menu
- - setMenu:
- - menu
- Managing key equivalents
- + setUsesUserKeyEquivalents:
- + usesUserKeyEquivalents
- - setKeyEquivalent:
- - keyEquivalent
- - setKeyEquivalentModifierMask:
- - keyEquivalentModifierMask
- Managing mnemonics
- - setMnemonicLocation:
- - mnemonicLocation
- - setTitleWithMnemonic:
- - mnemonic
- Managing user key equivalents
- - userKeyEquivalent
- Representing an object
- - setRepresentedObject:
- - representedObject
+ (void)setUsesUserKeyEquivalents:(BOOL)flag
See Also: + usesUserKeyEquivalents, - userKeyEquivalent
+ (BOOL)usesUserKeyEquivalents
See Also: + setUsesUserKeyEquivalents:, - userKeyEquivalent
- (SEL)action
See Also: - target, - setAction:
- (BOOL)hasSubmenu
See Also: - setSubmenuForItemsetSubmenu:forItem: (NSMenu)
- (NSImage *)image
See Also: - setImage:
- (id)initWithTitle:(NSString
*)itemName
action:(SEL)anAction
keyEquivalent:(NSString *)charCode
- (BOOL)isEnabled
See Also: - setEnabled:
- (BOOL)isSeparatorItem
- (NSString *)keyEquivalent
See Also: - userKeyEquivalent, - mnemonic, - setKeyEquivalent:
- (unsigned int)keyEquivalentModifierMask
See Also: - setKeyEquivalentModifierMask:
- (NSMenu *)menu
See Also: - setMenu:
- (NSImage *)mixedStateImage
See Also: - setMixedStateImage:
- (NSString *)mnemonic
See Also: - setTitleWithMnemonic:
- (unsigned)mnemonicLocation
NSNotFound
.
See Also: - setMnemonicLocation:
- (NSImage *)offStateImage
See Also: - setOffStateImage:
- (NSImage *)onStateImage
See Also: - setOnStateImage:
- (id)representedObject
See Also: - tag, - setRepresentedObject:
+ (id <NSMenuItem>)separatorItem
- (void)setAction:(SEL)aSelector
See Also: - setTarget:, - action
- (void)setEnabled:(BOOL)flag
See Also: - isEnabled
- (void)setImage:(NSImage
*)menuImage
See Also: - image
- (void)setKeyEquivalent:(NSString
*)aKeyEquivalent
See Also: - setMnemonicLocation:, - keyEquivalent
- (void)setKeyEquivalentModifierMask:(unsigned
int)mask
NSShiftKeyMask
NSAlternateKeyMask
NSCommandKeyMask
You should always set NSCommandKeyMask
in mask.
NSShiftKeyMask
is relevant
only for function keys; that is, for key events whose modifier flags
include NSFunctionKeyMask
. For all
other key events NSShiftKeyMask
is
ignored and characters typed while the Shift key is pressed are
interpreted as the shifted versions of those characters; for example, Command-Shift-'c'
is interpreted as Command-'C'.
See the NSEvent class specification for more information about modifier mask values.
See Also: - keyEquivalentModifierMask
- (void)setMenu:(NSMenu
*)aMenu
See Also: - menu
- (void)setMixedStateImage:(NSImage
*)itemImage
See Also: - mixedStateImage, - setOffStateImage:, - setOnStateImage:, - setState:
- (void)setMnemonicLocation:(unsigned)location
See Also: - mnemonicLocation
- (void)setOffStateImage:(NSImage
*)itemImage
See Also: - offStateImage, - setMixedStateImage:, - setOffStateImage:, - setState:
- (void)setOnStateImage:(NSImage
*)itemImage
See Also: - onStateImage, - setMixedStateImage:, - setOffStateImage:, - setState:
- (void)setRepresentedObject:(id)anObject
For example, an NSView object might be associated with a menu item-when the user chooses the menu item, the represented object is fetched and displayed in a panel. Several menu items might control the display of multiple views in the same panel.
See Also: - setTag:, - representedObject
- (void)setState:(int)itemState
NSOffState
, NSOnState
,
or NSMixedState
. The
image associated with the new state is displayed to the left of
the menu item.
See Also: - state, - setMixedStateImage:, - setOffStateImage:, - setOnStateImage:
- (void)setSubmenu:(NSMenu
*)aSubmenu
See Also: - submenu, - hasSubmenu
- (void)setTag:(int)anInt
See Also: - setRepresentedObject:, - tag
- (void)setTarget:(id)anObject
See Also: - setAction:, - target
- (void)setTitle:(NSString
*)aString
See Also: - title
- (void)setTitleWithMnemonic:(NSString
*)aString
[aMenuItem setTitleWithMnemonic:NSLocalizedString(@"Re&ceive")];
See Also: - mnemonic, - setMnemonicLocation:
- (int)state
NSOffState
(the default), NSOnState
,
or NSMixedState
.
See Also: - setState:
- (NSMenu *)submenu
See Also: - hasSubmenu, - setSubmenu:
- (int)tag
See Also: - representedObject, - setTag:
- (id)target
See Also: - action, - setTarget:
- (NSString *)title
See Also: - setTitle:
- (NSString *)userKeyEquivalent
See Also: - keyEquivalent
- (unsigned int)userKeyEquivalentModifierMask