---

Deprecated NSTableView Methods

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

Deprecated in Mac OS X v10.3

drawsGrid

Returns a Boolean value that indicates whether the receiver draws a grid. (Deprecated in Mac OS X v10.3. Use gridStyleMask instead.)

- (BOOL)drawsGrid

Availability

• Deprecated in Mac OS X v10.3.

Declared In

NSTableView.h

selectColumn:byExtendingSelection:

Selects a column at a given index, optionally extending any existing selection. (Deprecated in Mac OS X v10.3. Use selectColumnIndexes:byExtendingSelection: instead.)

- (void)selectColumn:(NSInteger)columnIndex byExtendingSelection:(BOOL)flag

Availability

• Deprecated in Mac OS X v10.3.

See Also

• – allowsMultipleSelection
• – allowsColumnSelection
• – deselectColumn:
• – selectedColumn
• – selectRow:byExtendingSelection:

Declared In

NSTableView.h

selectedColumnEnumerator

This method has been deprecated. (Deprecated in Mac OS X v10.3. Use selectedColumnIndexes instead.)

- (NSEnumerator *)selectedColumnEnumerator

Availability

• Deprecated in Mac OS X v10.3.

See Also

• – numberOfSelectedColumns
• – selectedColumn
• – selectedRowEnumerator

Declared In

NSTableView.h

selectedRowEnumerator

This method has been deprecated. (Deprecated in Mac OS X v10.3. Use selectedRowIndexes instead.)

- (NSEnumerator *)selectedRowEnumerator

Availability

• Deprecated in Mac OS X v10.3.

See Also

• – numberOfSelectedRows
• – selectedRow
• – selectedColumnEnumerator

Declared In

NSTableView.h

selectRow:byExtendingSelection:

Selects a row at a given index, optionally extending any existing selection. (Deprecated in Mac OS X v10.3. Use selectRowIndexes:byExtendingSelection: instead.)

- (void)selectRow:(NSInteger)rowIndex byExtendingSelection:(BOOL)flag

Availability

• Deprecated in Mac OS X v10.3.

See Also

• – allowsMultipleSelection
• – deselectRow:
• – selectedRow
• – selectColumn:byExtendingSelection:

Related Sample Code

• EnhancedAudioBurn
• OpenGLCompositorLab
• WhackedTV

Declared In

NSTableView.h

setDrawsGrid:

Sets whether the receiver draws a grid. (Deprecated in Mac OS X v10.3. Use setGridStyleMask: instead.)

- (void)setDrawsGrid:(BOOL)flag

Availability

• Deprecated in Mac OS X v10.3.

Declared In

NSTableView.h

Deprecated in Mac OS X v10.4 and later

dragImageForRows:event:dragImageOffset:

Computes and returns an image to use for dragging. (Deprecated in Mac OS X v10.4 and later. Use dragImageForRowsWithIndexes:tableColumns:event:offset: instead.)

- (NSImage *)dragImageForRows:(NSArray *)dragRows event:(NSEvent *)dragEvent dragImageOffset:(NSPointPointer)dragImageOffset

Discussion

Override this to return a custom image. dragRows represents the rows participating in the drag. dragEvent is a reference to the mouse-down event that began the drag. dragImageOffset is an in/out parameter.

This method is called with dragImageOffset set to NSZeroPoint, but it can be modified to reposition the returned image. A dragImageOffset of NSZeroPoint will cause the image to be centered under the cursor.

Availability

• Deprecated in Mac OS X v10.4 and later.

Declared In

NSTableView.h

setAutoresizesAllColumnsToFit:

Controls whether the receiver proportionally resizes its columns to fit when its superview’s frame changes. (Deprecated in Mac OS X v10.4 and later. Use setColumnAutoresizingStyle: instead.)

- (void)setAutoresizesAllColumnsToFit:(BOOL)flag

Discussion

If flag is YES, the difference in width is distributed among the receiver’s table columns; if flag is NO, only the last column is resized to fit.

To preserve compatibility this method sets the autoresizing style to NSTableViewUniformColumnAutoresizingStyle , if flag is YES. Otherwise the autoresizing style is set to NSTableViewLastColumnOnlyAutoresizingStyle.

Availability

• Deprecated in Mac OS X v10.4 and later.

See Also

• – setColumnAutoresizingStyle:

Declared In

NSTableView.h

Deprecated in Mac OS X v10.4

autoresizesAllColumnsToFit

Returns YES if the receiver proportionally resizes its columns to fit when its superview’s frame changes, NO if it only resizes the last column. (Deprecated in Mac OS X v10.4. Use columnAutoresizingStyle instead.)

- (BOOL)autoresizesAllColumnsToFit

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.4.

See Also

• – columnAutoresizingStyle
• – setColumnAutoresizingStyle:

Declared In

NSTableView.h

Deprecated in Mac OS X v10.5

columnsInRect:

Returns a range of indices for the receiver’s columns that lie wholly or partially within the horizontal boundaries of a given rectangle. (Deprecated in Mac OS X v10.5.)

- (NSRange)columnsInRect:(NSRect)aRect

Parameters

aRect

A rectangle in the coordinate system of the receiver.

Return Value

A range of indices for the receiver’s columns that lie wholly or partially within the horizontal boundaries of aRect. If the width or height of aRect is 0, returns an NSRange whose length is 0.

Discussion

The location of the range is the first such column’s index, and the length is the number of columns that lie in aRect.

Availability

• Available in Mac OS X v10.0 and later.
• Deprecated in Mac OS X v10.5.

See Also

• – rowsInRect:

Declared In

NSTableView.h

---