NSMatrix

NSMatrix Mac OS X 10.0

This NSView subclass specializes in organizing groups of cells in a grid, and endowing them with various collective behaviors such as that exhibited by radio buttons. Radio button groups are an example of an interface component implemented with an NSMatrix and NSButtonCells.

figs/cocn_1547.gif

@interface NSMatrix : NSControl
 // Initializers
   - (id)initWithFrame:(NSRect)frameRect;
   - (id)initWithFrame:(NSRect)frameRect mode:(int)aMode cellClass:(Class)factoryId numberOfRows:(int)rowsHigh
        numberOfColumns:(int)colsWide;
   - (id)initWithFrame:(NSRect)frameRect mode:(int)aMode prototype:(NSCell *)aCell numberOfRows:(int)rowsHigh
        numberOfColumns:(int)colsWide;
 // Accessor Methods
   - (void)setAllowsEmptySelection:(BOOL)flag;
   - (BOOL)allowsEmptySelection;
   - (void)setToolTip:(NSString *)toolTipString forCell:(NSCell *)cell;
   - (void)setCellClass:(Class)factoryId;
   - (Class)cellClass;
   - (void)setDelegate:(id)anObject;
   - (id)delegate;
   - (void)setAutoscroll:(BOOL)flag;
   - (void)setIntercellSpacing:(NSSize)aSize;
   - (NSSize)intercellSpacing;
   - (void)setValidateSize:(BOOL)flag;
   - (void)setCellBackgroundColor:(NSColor *)color;
   - (NSColor *)cellBackgroundColor;
   - (void)setMode:(NSMatrixMode)aMode;
   - (NSMatrixMode)mode;
   - (void)setSelectionByRect:(BOOL)flag;
   - (void)setSelectionFrom:(int)startPos to:(int)endPos anchor:(int)anchorPos highlight:(BOOL)lit;
   - (void)setAutosizesCells:(BOOL)flag;
   - (BOOL)autosizesCells;
   - (void)setCellSize:(NSSize)aSize;
   - (NSSize)cellSize;
   - (void)setScrollable:(BOOL)flag;
   - (void)setBackgroundColor:(NSColor *)color;
   - (NSColor *)backgroundColor;
   - (void)setDoubleAction:(SEL)aSelector;
   - (SEL)doubleAction;
   - (void)setPrototype:(NSCell *)aCell;
   - (id)prototype;
   - (void)setState:(int)value atRow:(int)row column:(int)col;
   - (void)setDrawsBackground:(BOOL)flag;
   - (BOOL)drawsBackground;
   - (void)setDrawsCellBackground:(BOOL)flag;
   - (BOOL)drawsCellBackground;
 // Instance Methods
   - (BOOL)acceptsFirstMouse:(NSEvent *)theEvent;
   - (void)addColumn;
   - (void)addColumnWithCells:(NSArray *)newCells;
   - (void)addRow;
   - (void)addRowWithCells:(NSArray *)newCells;
   - (id)cellAtRow:(int)row column:(int)col;
   - (NSRect)cellFrameAtRow:(int)row column:(int)col;
   - (id)cellWithTag:(int)anInt;
   - (NSArray *)cells;
   - (void)deselectAllCells;
   - (void)deselectSelectedCell;
   - (void)drawCellAtRow:(int)row column:(int)col;
   - (void)getNumberOfRows:(int *)rowCount columns:(int *)colCount;
   - (BOOL)getRow:(int *)row column:(int *)col forPoint:(NSPoint)aPoint;
   - (BOOL)getRow:(int *)row column:(int *)col ofCell:(NSCell *)aCell;
   - (void)highlightCell:(BOOL)flag atRow:(int)row column:(int)col;
   - (void)insertColumn:(int)column;
   - (void)insertColumn:(int)column withCells:(NSArray *)newCells;
   - (void)insertRow:(int)row;
   - (void)insertRow:(int)row withCells:(NSArray *)newCells;
   - (BOOL)isAutoscroll;
   - (BOOL)isSelectionByRect;
   - (NSCell *)makeCellAtRow:(int)row column:(int)col;
   - (void)mouseDown:(NSEvent *)theEvent;
   - (int)mouseDownFlags;
   - (int)numberOfColumns;
   - (int)numberOfRows;
   - (BOOL)performKeyEquivalent:(NSEvent *)theEvent;
   - (void)putCell:(NSCell *)newCell atRow:(int)row column:(int)col;
   - (void)removeColumn:(int)col;
   - (void)removeRow:(int)row;
   - (void)renewRows:(int)newRows columns:(int)newCols;
   - (void)resetCursorRects;
   - (void)scrollCellToVisibleAtRow:(int)row column:(int)col;
   - (void)selectAll:(id)sender;
   - (void)selectCellAtRow:(int)row column:(int)col;
   - (BOOL)selectCellWithTag:(int)anInt;
   - (void)selectText:(id)sender;
   - (id)selectTextAtRow:(int)row column:(int)col;
   - (id)selectedCell;
   - (NSArray *)selectedCells;
   - (int)selectedColumn;
   - (int)selectedRow;
   - (BOOL)sendAction;
   - (void)sendAction:(SEL)aSelector to:(id)anObject forAllCells:(BOOL)flag;
   - (void)sendDoubleAction;
   - (void)sizeToCells;
   - (void)sortUsingFunction:(int (*)(id, id, void *))compare context:(void *)context;
   - (void)sortUsingSelector:(SEL)comparator;
   - (void)textDidBeginEditing:(NSNotification *)notification;
   - (void)textDidChange:(NSNotification *)notification;
   - (void)textDidEndEditing:(NSNotification *)notification;
   - (BOOL)textShouldBeginEditing:(NSText *)textObject;
   - (BOOL)textShouldEndEditing:(NSText *)textObject;
   - (NSString *)toolTipForCell:(NSCell *)cell;

Subclasses

NSForm



    Part II: API Quick Reference
    Chapter 13. Foundation Classes