NSCell Class Reference

Tasks

Initializing a Cell

• – initImageCell:
• – initTextCell:

Managing Cell Values

• – setObjectValue:
• – objectValue
• – hasValidObjectValue
• – setIntValue:
• – intValue
• – setIntegerValue:
• – integerValue
• – setStringValue:
• – stringValue
• – setDoubleValue:
• – doubleValue
• – setFloatValue:
• – floatValue

Managing Cell Attributes

• – setCellAttribute:to:
• – cellAttribute:
• – setType:
• – type
• – setEnabled:
• – isEnabled
• – allowsUndo
• – setAllowsUndo:

Managing Display Attributes

• – setBezeled:
• – isBezeled
• – setBordered:
• – isBordered
• – isOpaque
• – setControlTint:
• – controlTint
• – setBackgroundStyle:
• – backgroundStyle
• – interiorBackgroundStyle

Managing Cell State

• – allowsMixedState
• – nextState
• – setAllowsMixedState:
• – setNextState
• – setState:
• – state

Modifying Textual Attributes

• – setEditable:
• – isEditable
• – setSelectable:
• – isSelectable
• – setScrollable:
• – isScrollable
• – setAlignment:
• – alignment
• – setFont:
• – font
• – lineBreakMode
• – setLineBreakMode:
• – truncatesLastVisibleLine
• – setTruncatesLastVisibleLine:
• – setWraps:
• – wraps
• – baseWritingDirection
• – setBaseWritingDirection:
• – setAttributedStringValue:
• – attributedStringValue
• – setAllowsEditingTextAttributes:
• – allowsEditingTextAttributes
• – setImportsGraphics:
• – importsGraphics
• – setUpFieldEditorAttributes:
• – title
• – setTitle:

Managing the Target and Action

• – setAction:
• – action
• – setTarget:
• – target
• – setContinuous:
• – isContinuous
• – sendActionOn:

Managing the Image

• – setImage:
• – image

Managing the Tag

• – setTag:
• – tag

Formatting and Validating Data

• – setFormatter:
• – formatter
• – entryType Deprecated in OS X v10.0 and later
• – setEntryType: Deprecated in OS X v10.0 and later
• – isEntryAcceptable: Deprecated in OS X v 10.0 and later
• – setFloatingPointFormat:left:right: Deprecated in OS X v10.0

Managing Menus

• + defaultMenu
• – setMenu:
• – menu
• – menuForEvent:inRect:ofView:

Comparing Cells

• – compare:

Respond to Keyboard Events

• – acceptsFirstResponder
• – setShowsFirstResponder:
• – showsFirstResponder
• – refusesFirstResponder
• – setRefusesFirstResponder:
• – performClick:
• – mnemonic Deprecated in OS X v10.8
• – mnemonicLocation Deprecated in OS X v10.8
• – setMnemonicLocation: Deprecated in OS X v10.8
• – setTitleWithMnemonic: Deprecated in OS X v10.8

Deriving Values

• – takeObjectValueFrom:
• – takeIntegerValueFrom:
• – takeIntValueFrom:
• – takeStringValueFrom:
• – takeDoubleValueFrom:
• – takeFloatValueFrom:

Representing an Object

• – setRepresentedObject:
• – representedObject

Tracking the Mouse

• – trackMouse:inRect:ofView:untilMouseUp:
• – startTrackingAt:inView:
• – continueTracking:at:inView:
• – stopTracking:at:inView:mouseIsUp:
• – mouseDownFlags
• + prefersTrackingUntilMouseUp
• – getPeriodicDelay:interval:

Hit Testing

• – hitTestForEvent:inRect:ofView:

Managing the Cursor

• – resetCursorRect:inView:

Handling Keyboard Alternatives

• – keyEquivalent

Dragging Cells

• – draggingImageComponentsWithFrame:inView:

Managing Focus Rings

• – drawFocusRingMaskWithFrame:inView:
• – focusRingMaskBoundsForFrame:inView:
• + defaultFocusRingType
• – setFocusRingType:
• – focusRingType

Determining Cell Size

• – calcDrawInfo:
• – cellSize
• – cellSizeForBounds:
• – drawingRectForBounds:
• – imageRectForBounds:
• – titleRectForBounds:
• – controlSize
• – setControlSize:

Drawing and Highlighting

• – drawWithFrame:inView:
• – highlightColorWithFrame:inView:
• – drawInteriorWithFrame:inView:
• – controlView
• – setControlView:
• – highlight:withFrame:inView:
• – setHighlighted:
• – isHighlighted

Editing and Selecting Text

• – editWithFrame:inView:editor:delegate:event:
• – selectWithFrame:inView:editor:delegate:start:length:
• – sendsActionOnEndEditing
• – setSendsActionOnEndEditing:
• – endEditing:
• – wantsNotificationForMarkedText
• – fieldEditorForView:
• – usesSingleLineMode
• – setUsesSingleLineMode:

Managing Expansion Frames

• – expansionFrameWithFrame:inView:
• – drawWithExpansionFrame:inView:

User Interface Layout Direction

• – setUserInterfaceLayoutDirection:
• – userInterfaceLayoutDirection

NSColor *txtColor = [NSColor redColor];

NSFont *txtFont = [NSFont boldSystemFontOfSize:14];

NSDictionary *txtDict = [NSDictionary dictionaryWithObjectsAndKeys:

        txtFont, NSFontAttributeName, txtColor, NSForegroundColorAttributeName, nil];

NSAttributedString *attrStr = [[[NSAttributedString alloc]

        initWithString:@"Hello!" attributes:txtDict] autorelease];

[[attrStrTextField cell] setAttributedStringValue:attrStr];

[attrStrTextField updateCell:[attrStrTextField cell]];

- (void)stopTracking:(NSPoint)lastPoint at:(NSPoint)stopPoint

    inView:(NSView *)controlView mouseIsUp:(BOOL)flag

{

    if (flag == YES) {

        [self setTriState:([self triState]+1)];

    }

}

enum {
   NSNullCellType  = 0,
   NSTextCellType  = 1,
   NSImageCellType = 2
};
typedef NSUInteger NSCellType;

enum {
   NSCellDisabled               = 0,
   NSCellState                  = 1,
   NSPushInCell                 = 2,
   NSCellEditable               = 3,
   NSChangeGrayCell             = 4,
   NSCellHighlighted            = 5,
   NSCellLightsByContents       = 6,
   NSCellLightsByGray           = 7,
   NSChangeBackgroundCell       = 8,
   NSCellLightsByBackground     = 9,
   NSCellIsBordered             = 10,
   NSCellHasOverlappingImage    = 11,
   NSCellHasImageHorizontal     = 12,
   NSCellHasImageOnLeftOrBottom = 13,
   NSCellChangesContents        = 14,
   NSCellIsInsetButton          = 15,
   NSCellAllowsMixedState       = 16
};
typedef NSUInteger NSCellAttribute;

enum {
   NSNoImage       = 0,
   NSImageOnly     = 1,
   NSImageLeft     = 2,
   NSImageRight    = 3,
   NSImageBelow    = 4,
   NSImageAbove    = 5,
   NSImageOverlaps = 6
};
typedef NSUInteger NSCellImagePosition;

enum {
   NSImageScaleProportionallyDown = 0,
   NSImageScaleAxesIndependently,
   NSImageScaleNone,
   NSImageScaleProportionallyUpOrDown
};
typedef NSUInteger NSImageScaling;

enum {
   NSMixedState = -1,
   NSOffState   = 0,
   NSOnState    = 1
};
typedef NSUInteger NSCellStateValue;

enum {
   NSNoCellMask               = 0,
   NSContentsCellMask         = 1,
   NSPushInCellMask           = 2,
   NSChangeGrayCellMask       = 4,
   NSChangeBackgroundCellMask = 8
};

enum {
   NSDefaultControlTint  = 0,
   NSBlueControlTint     = 1,
   NSGraphiteControlTint = 6,
   NSClearControlTint    = 7
};
typedef NSUInteger NSControlTint;

enum {
   NSRegularControlSize,
   NSSmallControlSize,
   NSMiniControlSize
};
typedef NSUInteger NSControlSize;

enum {
   NSCellHitNone = 0,
   NSCellHitContentArea = 1 << 0,
   NSCellHitEditableTextArea = 1 << 1,
   NSCellHitTrackableArea = 1 << 2,
};

enum {
   NSBackgroundStyleLight = 0,
   NSBackgroundStyleDark,
   NSBackgroundStyleRaised,
   NSBackgroundStyleLowered
};
typedef NSUInteger NSBackgroundStyle;

enum {
   NSScaleProportionally = 0,
   NSScaleToFit,
   NSScaleNone
};

enum {
   NSAnyType            = 0,
   NSIntType            = 1,
   NSPositiveIntType    = 2,
   NSFloatType          = 3,
   NSPositiveFloatType  = 4,
   NSDoubleType         = 6,
   NSPositiveDoubleType = 7
};