NSTableView Class Reference

Tasks

Creating the Displayed Views

• – makeViewWithIdentifier:owner:
• – rowViewAtRow:makeIfNecessary:
• – viewAtColumn:row:makeIfNecessary:

Setting the Data Source

• – setDataSource:
• – dataSource

Loading Data

• – reloadData
• – reloadDataForRowIndexes:columnIndexes:

Using Views for Row and Column Content

• – beginUpdates
• – endUpdates
• – columnForView:
• – moveRowAtIndex:toIndex:
• – insertRowsAtIndexes:withAnimation:
• – removeRowsAtIndexes:withAnimation:
• – rowForView:

View-based Table Nib Registration

• – registerNib:forIdentifier:
• – registeredNibsByIdentifier

Target-action Behavior

• – setDoubleAction:
• – doubleAction
• – clickedColumn
• – clickedRow

Configuring Behavior

• – setAllowsColumnReordering:
• – allowsColumnReordering
• – setAllowsColumnResizing:
• – allowsColumnResizing
• – setAllowsMultipleSelection:
• – allowsMultipleSelection
• – setAllowsEmptySelection:
• – allowsEmptySelection
• – setAllowsColumnSelection:
• – allowsColumnSelection

Setting Display Attributes

• – setIntercellSpacing:
• – intercellSpacing
• – setRowHeight:
• – rowHeight
• – setBackgroundColor:
• – backgroundColor
• – setUsesAlternatingRowBackgroundColors:
• – usesAlternatingRowBackgroundColors
• – selectionHighlightStyle
• – setSelectionHighlightStyle:
• – setGridColor:
• – gridColor
• – setGridStyleMask:
• – gridStyleMask
• – indicatorImageInTableColumn:
• – setIndicatorImage:inTableColumn:

Getting and Setting Row Size Styles

• – effectiveRowSizeStyle
• – rowSizeStyle
• – setRowSizeStyle:

Column Management

• – addTableColumn:
• – removeTableColumn:
• – moveColumn:toColumn:
• – tableColumns
• – columnWithIdentifier:
• – tableColumnWithIdentifier:

Selecting Columns and Rows

• – selectColumnIndexes:byExtendingSelection:
• – selectedColumn
• – selectedColumnIndexes
• – deselectColumn:
• – numberOfSelectedColumns
• – isColumnSelected:
• – selectRowIndexes:byExtendingSelection:
• – selectedRow
• – selectedRowIndexes
• – deselectRow:
• – numberOfSelectedRows
• – isRowSelected:
• – selectAll:
• – deselectAll:

Enumerating Table Rows

• – enumerateAvailableRowViewsUsingBlock:

Managing Type Select

• – allowsTypeSelect
• – setAllowsTypeSelect:

Getting and Setting Column Focus

• – focusedColumn
• – setFocusedColumn:
• – shouldFocusCell:atColumn:row:

Table Dimensions

• – numberOfColumns
• – numberOfRows

Displaying Cell

• – preparedCellAtColumn:row:

Getting and Setting Floating Rows

• – floatsGroupRows
• – setFloatsGroupRows:

Editing Cells

• – editColumn:row:withEvent:select:
• – editedColumn
• – editedRow
• – performClickOnCellAtColumn:row:

Setting Auxiliary Views

• – setHeaderView:
• – headerView
• – setCornerView:
• – cornerView

Layout Support

• – rectOfColumn:
• – rectOfRow:
• – rowsInRect:
• – columnIndexesInRect:
• – columnAtPoint:
• – rowAtPoint:
• – frameOfCellAtColumn:row:
• – columnAutoresizingStyle
• – setColumnAutoresizingStyle:
• – sizeLastColumnToFit
• – noteNumberOfRowsChanged
• – tile
• – sizeToFit
• – noteHeightOfRowsWithIndexesChanged:
• – columnsInRect: Deprecated in OS X v10.5

Drawing

• – drawRow:clipRect:
• – drawGridInClipRect:
• – highlightSelectionInClipRect:
• – drawBackgroundInClipRect:

Scrolling

• – scrollRowToVisible:
• – scrollColumnToVisible:

Table Column State Persistence

• – setAutosaveName:
• – autosaveName
• – setAutosaveTableColumns:
• – autosaveTableColumns

Setting the Delegate

• – setDelegate:
• – delegate

Highlightable Column Headers

• – highlightedTableColumn
• – setHighlightedTableColumn:

Dragging

• – dragImageForRowsWithIndexes:tableColumns:event:offset:
• – canDragRowsWithIndexes:atPoint:
• – setDraggingSourceOperationMask:forLocal:
• – setVerticalMotionCanBeginDrag:
• – verticalMotionCanBeginDrag
• – draggingDestinationFeedbackStyle
• – setDraggingDestinationFeedbackStyle:
• – setDropRow:dropOperation:

Sorting

• – setSortDescriptors:
• – sortDescriptors

Text Delegate Methods

• – textShouldBeginEditing:
• – textDidBeginEditing:
• – textDidChange:
• – textShouldEndEditing:
• – textDidEndEditing:

Deprecated Methods

• – drawsGrid Deprecated in OS X v10.3
• – selectColumn:byExtendingSelection: Deprecated in OS X v10.3
• – selectedColumnEnumerator Deprecated in OS X v10.3
• – selectedRowEnumerator Deprecated in OS X v10.3
• – selectRow:byExtendingSelection: Deprecated in OS X v10.3
• – setDrawsGrid: Deprecated in OS X v10.3
• – autoresizesAllColumnsToFit Deprecated in OS X v10.4
• – dragImageForRows:event:dragImageOffset: Deprecated in OS X v10.4
• – setAutoresizesAllColumnsToFit: Deprecated in OS X v10.4
• – tableView:writeRows:toPasteboard:  delegate method Deprecated in OS X v10.4

[aTableView setNeedsDisplayInRect:[aTableView rectOfColumn:column]];

[aTableView setNeedsDisplayInRect:[aTableView rectOfRow:row]];

NSString *const NSTableViewRowViewKey;

enum {
   NSTableViewDraggingDestinationFeedbackStyleNone = -1,
   NSTableViewDraggingDestinationFeedbackStyleRegular = 0,
   NSTableViewDraggingDestinationFeedbackStyleSourceList = 1,
};
#endif
typedef NSInteger NSTableViewDraggingDestinationFeedbackStyle;

enum {
   NSTableViewDropOn,
   NSTableViewDropAbove
};
typedef NSUInteger NSTableViewDropOperation;

enum {
   NSTableViewGridNone                    = 0,
   NSTableViewSolidVerticalGridLineMask   = 1 << 0,
   NSTableViewSolidHorizontalGridLineMask = 1 << 1,
   NSTableViewDashedHorizontalGridLineMask = 1 << 3,
};
typedef NSUInteger NSTableViewGridLineStyle;

enum {
   NSTableViewNoColumnAutoresizing = 0,
   NSTableViewUniformColumnAutoresizingStyle,
   NSTableViewSequentialColumnAutoresizingStyle,
   NSTableViewReverseSequentialColumnAutoresizingStyle,
   NSTableViewLastColumnOnlyAutoresizingStyle,
   NSTableViewFirstColumnOnlyAutoresizingStyle
};
typedef NSUInteger NSTableViewColumnAutoresizingStyle;

   
enum {
   NSTableViewSelectionHighlightStyleNone = -1,
   NSTableViewSelectionHighlightStyleRegular = 0,
   NSTableViewSelectionHighlightStyleSourceList = 1,
};
typedef NSInteger NSTableViewSelectionHighlightStyle;

enum {
   NSTableViewAnimationEffectNone = 0x0,
};

enum {
   NSTableViewAnimationEffectFade = 0x1,
   NSTableViewAnimationEffectGap = 0x2,
};

enum {
   NSTableViewAnimationSlideUp = 0x10,
   NSTableViewAnimationSlideDown = 0x20,
   NSTableViewAnimationSlideLeft = 0x30,
   NSTableViewAnimationSlideRight = 0x40,
};
typedef NSUInteger NSTableViewAnimationOptions;

enum {
   NSTableViewRowSizeStyleDefault = -1,
   NSTableViewRowSizeStyleCustom = 0,
   NSTableViewRowSizeStyleSmall = 1,
   NSTableViewRowSizeStyleMedium = 2,
   NSTableViewRowSizeStyleLarge = 3,
};
typedef NSInteger NSTableViewRowSizeStyle;