Using Menu Item States
Menu items can have a state: on (
NSOnState), off (
NSOffState), or mixed (
NSMixedState). These are useful if the menu item represents a setting in your application. The menu item automatically displays its state, as follows. If the state is
NSOnState, a checkmark appears beside it. If the state is
NSMixedState, a dash appears beside it. If the state is
NSOffState, nothing appears beside it. To set the menu item’s state, use
The mixed state is useful if the setting is true for only some items in the application or the current selection. For example, if some of the selected characters in a word processor document are italic and others are not, the Italic menu item would have a dash beside it. If the menu item is in the mixed state, then choosing it should cycle through all three states. Going back to the mixed state should leave the selection as it was.
You can use states to implement a group of mutually exclusive menu items, much like a group of radio buttons. For example, a game could have three menu items to show the level of play: Beginner, Intermediate, and Advanced. To implement a such a group, create one action message that they all use. This action message changes the appropriate setting, and then reflects that change by unchecking the currently checked item and checking the newly selected item.
In an action method that responds to all commands in the group use
setState: to uncheck the menu item that is currently marked:
Then mark the newly selected command:
© 2001, 2007 Apple Inc. All Rights Reserved. (Last updated: 2007-06-26)