Deprecated NSButtonCell Methods

A method identified as deprecated has been superseded and may become unsupported in the future.

Deprecated in OS X v10.8

alternateMnemonic

Returns the character in the alternate title that’s marked as the “keyboard mnemonic.” (Deprecated in OS X v10.8.)

- (NSString *)alternateMnemonic
Return Value

The character in the alternate title (the title displayed on the receiver when it's in its alternate state) marked as the "keyboard mnemonic."

Discussion

Mnemonics are not supported in OS X.

Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.8.
Declared In
NSButtonCell.h

alternateMnemonicLocation

Returns an unsigned integer indicating the character in the alternate title that’s marked as the “keyboard mnemonic.” (Deprecated in OS X v10.8.)

- (NSUInteger)alternateMnemonicLocation
Return Value

An unsigned integer indicating the character in the alternate title (the title displayed on the receiver when it’s in its alternate state) that’s marked as the “keyboard mnemonic.” If the alternate title doesn’t have a keyboard mnemonic, returns NSNotFound.

Discussion

Mnemonics are not supported in OS X.

Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.8.
Declared In
NSButtonCell.h

setAlternateMnemonicLocation:

Sets the character in the alternate title that should be the “keyboard mnemonic.” (Deprecated in OS X v10.8.)

- (void)setAlternateMnemonicLocation:(NSUInteger)location
Parameters
location

An unsigned integer indicating the character in the alternate title that should be marked as the "keyboard mnemonic." If you don’t want the alternate title to have a keyboard mnemonic, specify a location of NSNotFound.

Discussion

Mnemonics are not supported in OS X.

The setAlternateMnemonicLocation: method doesn’t cause the button cell to be redisplayed.

Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.8.
Declared In
NSButtonCell.h

setAlternateTitleWithMnemonic:

Sets the title the button displays when it’s in its alternate state to the given string with an embedded mnemonic. (Deprecated in OS X v10.8.)

- (void)setAlternateTitleWithMnemonic:(NSString *)aString
Parameters
aString

The string to set as the button's alternate title, taking into account the fact that an embedded “&” character is not a literal but instead marks the alternate state’s “keyboard mnemonic.”

Discussion

Mnemonics are not supported in OS X.

If necessary, setAlternateTitleWithMnemonic: redraws the button cell. Note that some button types don’t display an alternate title.

Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.8.
Declared In
NSButtonCell.h

setTitleWithMnemonic:

Sets the title the button displays when it’s in its normal state to the given string with an embedded mnemonic. (Deprecated in OS X v10.8.)

- (void)setTitleWithMnemonic:(NSString *)aString
Parameters
aString

The string to set as the button's title, taking into account the fact that an embedded “&” character is not a literal but instead marks the alternate state’s “keyboard mnemonic.” This title is always shown on buttons that don’t use their alternate contents when highlighting or displaying their alternate state.

Discussion

If necessary, setTitleWithMnemonic: redraws the button cell. Mnemonics are not supported in OS X.

Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.8.
Declared In
NSButtonCell.h