Instance Method

tableView:toolTipForCell:rect:tableColumn:row:mouseLocation:

Asks the delegate for a string to display in a tooltip for the specified cell in the column and row.

Declaration

- (NSString *)tableView:(NSTableView *)tableView toolTipForCell:(NSCell *)cell rect:(NSRectPointer)rect tableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row mouseLocation:(NSPoint)mouseLocation;

Parameters

aTableView

The table view that sent the message.

aCell

The cell.

rect

The proposed active area of the tooltip. You can modify rect to provide an alternative active area.

aTableColumn

The table column.

row

The row index.

mouseLocation

The mouse location.

Return Value

A string that should be displayed in the tooltip. Return nil or the empty string if no tooltip is desired.

Discussion

By default, rect is computed as

[cell drawingRectForBounds:cellFrame]. Note that tooltips are also known as help tags.

See Also

Providing Cells for Rows and Columns

- tableView:willDisplayCell:forTableColumn:row:

Tells the delegate that the table view will display the specified cell at the specified row and column.

- tableView:dataCellForTableColumn:row:

Asks the delegate for a custom data cell for the specified row and column.

- tableView:shouldShowCellExpansionForTableColumn:row:

Asks the delegate if an expansion tooltip should be displayed for a specific row and column.