Deprecated NSCell Methods

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

Deprecated in OS X v 10.0 and later

isEntryAcceptable:

Returns whether a string representing a numeric or date value is formatted in a suitable way for the cell's entry type. (Deprecated in OS X v 10.0 and later. Use NSFormatter instead.)

- (BOOL)isEntryAcceptable:(NSString *)aString
Parameters
aString

A string containing the numeric or date value.

Return Value

YES if aString is formatted appropriately for the receiver, otherwise NO.

Availability
  • Deprecated in OS X v 10.0 and later.
Declared In
NSCell.h

Deprecated in OS X v10.0

entryType

Returns the type of data the user can type into the receiver. (Deprecated in OS X v10.0. Use a formatter instead—see setFormatter:.)

- (NSInteger)entryType
Return Value

One of the types listed for this method in “Data Entry Types”. If the receiver is not a text-type cell, or if no type has been set, NSAnyType is returned.

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

setEntryType:

Sets how numeric data is formatted in the receiver and places restrictions on acceptable input. (Deprecated in OS X v10.0. Use a formatter instead—see setFormatter:.)

- (void)setEntryType:(NSInteger)aType
Parameters
aType

One of the types listed for this method in “Data Entry Types”.

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

setFloatingPointFormat:left:right:

Sets the auto-ranging and floating point number format of the receiver’s cell. (Deprecated in OS X v10.0. Use a formatter instead. See setFormatter:)

- (void)setFloatingPointFormat:(BOOL)autoRange left:(NSUInteger)leftDigits right:(NSUInteger)rightDigits
Parameters
autoRange

If YES, auto-ranging is enabled, otherwise it is disabled.

leftDigits

The number of digits to display to the left of the decimal point.

rightDigits

The number of digits to display to the right of the decimal point.

Discussion

Sets whether floating-point numbers are auto-ranged in the receiver and sets the sizes of the fields to the left and right of the decimal point. If autoRange is NO, leftDigits specifies the maximum number of digits to the left of the decimal point, and rightDigits specifies the number of digits to the right (the fractional digit places will be padded with zeros to fill this width). However, if a number is too large to fit its integer part in leftDigits digits, as many places as are needed on the left are effectively removed from rightDigits when the number is displayed.

If autoRange is YES, leftDigits and rightDigits are simply added to form a maximum total field width for the receiver (plus 1 for the decimal point). The fractional part will be padded with zeros on the right to fill this width, or truncated as much as possible (up to removing the decimal point and displaying the number as an integer). The integer portion of a number is never truncated—that is, it is displayed in full no matter what the field width limit is.

The following example sets a cell used to display dollar amounts up to 99,999.99:

    [[currencyDollarsField cell] setEntryType:NSFloatType];
    [[currencyDollarsField cell] setFloatingPointFormat:NO left:5  right:2];
Availability
  • Available in OS X v10.0 and later.
  • Deprecated in OS X v10.0.
Declared In
NSCell.h

Deprecated in OS X v10.8

mnemonic

Returns the character in the receiver’s title that appears underlined for use as a mnemonic. (Deprecated in OS X v10.8.)

- (NSString *)mnemonic
Return Value

A string containing the mnemonic character, or an empty string if no mnemonic character is set.

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
NSCell.h

mnemonicLocation

Returns the position of the underlined mnemonic character in the receiver’s title. (Deprecated in OS X v10.8.)

- (NSUInteger)mnemonicLocation
Return Value

A zero-based index into the receiver's title string indicating the position of the character. If there is no mnemonic character, this method 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
NSCell.h

setMnemonicLocation:

Sets the character of the receiver’s title to be used as a mnemonic character. (Deprecated in OS X v10.8.)

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

The zero-based index into the cell's title string specifying the location of the mnemonic character. The specified character is underlined when the title is drawn.

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
NSCell.h

setTitleWithMnemonic:

Sets the title of the receiver with one character in the string denoted as an access key. (Deprecated in OS X v10.8.)

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

The new title of the cell. One character in the string should be preceded by an ampersand (&) character. The character that follows becomes the mnemonic character for the title.

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
NSCell.h