A mechanism for displaying text or images in a view object without the overhead of a full NSView subclass.
SDK
Framework
@interface NSCell : NSObject
Cells are used by most of the NSControl classes to implement their internal workings.
When subclassing NSCell you must implement all of the designated initializers. Those methods include init, init, init, and init.
- initReturns an NSCell object initialized with the specified image and set to have the cell’s default menu.
- initReturns an NSCell object initialized with the specified string and set to have the cell’s default menu.
objectThe cell’s value as an Objective-C object.
hasA Boolean value that indicates whether the cell has a valid object value.
intThe cell’s value as an integer.
integerThe cell’s value as an NSInteger type.
stringThe cell’s value as a string.
doubleThe cell’s value as a double-precision floating-point number.
floatThe cell’s value as a single-precision floating-point number.
- setSets the value for the specified cell attribute.
- cellReturns the value for the specified cell attribute.
typeThe type of the cell.
enabledA Boolean value indicating whether the cell is currently enabled.
allowsA Boolean value indicating whether the cell assumes responsibility for undo operations.
bezeledA Boolean value indicating whether the cell has a bezeled border.
borderedA Boolean value indicating whether the cell draws itself outlined with a plain border.
opaqueA Boolean value indicating whether the cell is completely opaque.
backgroundThe cell’s background style.
interiorThe cell’s interior background style.
NSBackgroundBackground styles used with the background and interior properties.
allowsA Boolean value indicating whether the cell supports three states instead of two.
nextThe cell’s next state.
- setChanges cell’s state to the next value in the sequence.
stateThe cell’s current state.
editableA Boolean value indicating whether the cell is editable.
selectableA Boolean value indicating whether the cell’s text can be selected.
scrollableA Boolean value indicating whether excess text scrolls past the cell’s bounds.
alignmentThe alignment of the cell’s text.
fontThe font that the cell uses to display text.
lineThe line break mode to use when drawing text in the cell.
truncatesA Boolean value indicating whether the cell truncates text that does not fit within the cell’s bounds.
wrapsA Boolean value indicating whether the cell wraps text whose length that exceeds the cell’s frame.
baseThe initial writing direction used to determine the actual writing direction for text.
attributedThe cell’s value as an attributed string.
allowsA Boolean value indicating whether the cell allows the editing of its content’s text attributes by the user.
importsA Boolean value indicating whether the cell supports the importation of images into its text.
- setConfigures the textual and background attributes of the receiver's field editor.
titleThe cell’s title text.
actionThe action performed by the cell.
targetThe object that receives the cell’s action messages.
continuousA Boolean value indicating whether the cell sends its action message continuously during mouse tracking.
- sendSets the conditions on which the receiver sends action messages to its target.
imageThe image displayed by the cell, if any.
tagA tag for identifying the cell.
formatterThe cell’s formatter object.
defaultReturns the default menu for instances of the cell.
menuThe cell’s contextual menu.
- menuReturns the menu associated with the cell and related to the specified event and frame.
- compare:Compares the string values of the receiver another cell, disregarding case.
acceptsA Boolean value indicating whether the cell accepts first responder status.
showsA Boolean value indicating whether the cell provides a visual indication that it is the first responder.
refusesA Boolean value indicating whether the cell refuses the first responder status.
- performSimulates a single mouse click on the receiver.
- takeSets the value of the receiver’s cell to the object value obtained from the specified object.
- takeSets the value of the receiver’s cell to an integer value obtained from the specified object.
- takeSets the value of the receiver’s cell to an integer value obtained from the specified object.
- takeSets the value of the receiver’s cell to the string value obtained from the specified object.
- takeSets the value of the receiver’s cell to a double-precision floating-point value obtained from the specified object.
- takeSets the value of the receiver’s cell to a single-precision floating-point value obtained from the specified object.
representedThe object represented by the cell.
- trackInitiates the mouse tracking behavior in a cell.
- startBegins tracking mouse events within the receiver.
- continueReturns a Boolean value that indicates whether mouse tracking should continue in the receiving cell.
- stopStops tracking mouse events within the receiver.
mouseThe modifier flags for the last (left) mouse-down event.
prefersReturns a Boolean value that indicates whether tracking stops when the cursor leaves the cell.
- getReturns the initial delay and repeat values for continuous sending of action messages to target objects.
- hitReturns hit testing information for the receiver.
- resetSets the receiver to show the I-beam cursor while it tracks the mouse.
keyThe key equivalent associated with clicking the cell.
- draggingGenerates dragging image components with the specified frame in the view.
- drawDraws the focus ring for the control.
- focusReturns the bounds of the focus ring mask.
defaultReturns the default type of focus ring for the receiver.
focusThe type of focus ring to use with the associated view.
- calcRecalculates the cell geometry.
cellThe minimum size needed to display the cell.
- cellReturns the minimum size needed to display the receiver, constraining it to the specified rectangle.
- drawingReturns the rectangle within which the receiver draws itself
- imageReturns the rectangle in which the receiver draws its image.
- titleReturns the rectangle in which the receiver draws its title text.
controlThe size of the cell.
- drawDraws the receiver’s border and then draws the interior of the cell.
- highlightReturns the color the receiver uses when drawing the selection highlight.
- drawDraws the interior portion of the receiver, which includes the image or text portion but does not include the border.
controlThe view associated with the cell.
- highlight:Redraws the receiver with the specified highlight setting.
highlightedA Boolean value indicating whether the cell has a highlighted appearance.
- editBegins editing of the receiver’s text using the specified field editor.
- selectSelects the specified text range in the cell's field editor.
sendsA Boolean value indicating whether the cell’s control object sends its action message when the user finishes editing the cell’s text.
- endEnds the editing of text in the receiver using the specified field editor.
wantsA Boolean value indicating whether the cell’s field editor should post text change notifications.
- fieldReturns a custom field editor for editing in the view.
usesA Boolean value indicating whether the cell restricts layout and rendering of text to a single line.
- expansionReturns the expansion cell frame for the receiver.
- drawInstructs the receiver to draw in an expansion frame.
userThe layout direction of the user interface.
NSCellConstants for specifying how a cell represents its data (as text or as an image).
NSCellConstants for specifying how a button behaves when pressed and how it displays its state.
NSCellConstants for specifying the position of a button’s image relative to its title.
NSImageConstants that specify a cell’s image scaling behavior.
NSCellConstants for specifying what happens when a button is pressed or is displaying its alternate state.
NSControlConstants for specifying a cell’s tint color.
NSControlConstants for specifying a cell’s size.
NSCellConstants used by the hit method to determine the effect of an event.
NSBackgroundBackground styles used with the background and interior properties.
Deprecated Scaling ConstantsThese are deprecated scaling constants.
Data Entry TypesThese constants specify how a cell formats numeric data.
- setSets how numeric data is formatted in the receiver and places restrictions on acceptable input.
- isReturns whether a string representing a numeric or date value is formatted in a suitable way for the cell's entry type.
- setSets the auto-ranging and floating point number format of the receiver’s cell.
- setSets the title of the receiver with one character in the string denoted as an access key.
- mnemonicReturns the character in the receiver’s title that appears underlined for use as a mnemonic.
- setSets the character of the receiver’s title to be used as a mnemonic character.
- mnemonicReturns the position of the underlined mnemonic character in the receiver’s title.
NSViewThe infrastructure for drawing, printing, and handling events in an app.
NSControlA definition of the fundamental behavior for controls, which are specialized views that notify your app of relevant events by using the target-action design pattern.
NSActionAn active area inside a control.