Platforms to show: All Mac Windows Linux Cross-Platform

Back to NSTableViewMBS class.

NSTableViewMBS.SelectionDidChange(notification as NSNotificationMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 9.2 ✅ Yes ❌ No ❌ No ❌ No Desktop only
This event informs you that the table view's selection has changed.

NSTableViewMBS.selectionIndexesForProposedSelection(proposedSelectionIndexes as NSIndexSetMBS) as NSIndexSetMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Invoked to allow the delegate to modify the proposed selection.

proposedSelectionIndexes: An index set containing the indexes of the proposed selection.

Return an NSIndexSet instance containing the indexes of the new selection. Return proposedSelectionIndexes if the proposed selection is acceptable, or the value of the table view's existing selection to avoid changing the selection.

This method may be called multiple times with one new index added to the existing selection to find out if a particular index can be selected when the user is extending the selection with the keyboard or mouse.

Implementation of this method is optional. If implemented, this method will be called instead of shouldSelectRow.
Available in Mac OS X v10.5 and later.

NSTableViewMBS.SelectionIsChanging(notification as NSNotificationMBS)

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 9.2 ✅ Yes ❌ No ❌ No ❌ No Desktop only
This event informs you that the table view's selection is in the process of changing (typically because the user is dragging the mouse across a number of rows).

NSTableViewMBS.selectionShouldChangeInTableView as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns whether the selection should change.

Return true to allow the table view to change its selection (typically a row being edited), false to deny selection change.

The user can select and edit different cells within the same row, but can't select another row unless the delegate approves. The subclass can implement this method for complex validation of edited rows based on the values of any of their cells.

NSTableViewMBS.shouldEditTableColumn(tableColumn as NSTableColumnMBS, row as Int64) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns whether the cell at the specified row and column can be edited.

TableColumn: The table column.
rowIndex: The row index.
Return true to allow editing the cell, false to deny editing.

The subclass can implement this method to disallow editing of specific cells.
Note: This method is only valid for cell-based table views.

NSTableViewMBS.shouldReorderColumn(columnIndex as Int64, newColumnIndex as Int64) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Sent to the subclass to allow or prohibit the specified column to be dragged to a new location.

columnIndex: The index of the column being dragged.
newColumnIndex: The proposed target index of the column.

Return true if the column reordering should be allowed, otherwise false.

When a column is initially dragged by the user, the delegate is first called with a newColumnIndex value of -1. Returning false will disallow that column from being reordered at all. Returning true allows it to be reordered, and the delegate will be called again when the column reaches a new location.

The actual NSTableColumn instance can be retrieved from the tableColumns array.

If this method is not implemented, all columns are considered reorderable.
Available in Mac OS X v10.6 and later.

NSTableViewMBS.shouldSelectRow(row as Int64) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns whether the table view should allow selection of the specified row.

rowIndex: The row index.

Return true to permit selection of the row, false to deny selection.

The delegate can implement this method to disallow selection of particular rows.
For better performance and finer-grain control over the selection, use selectionIndexesForProposedSelection.

NSTableViewMBS.shouldSelectTableColumn(tableColumn as NSTableColumnMBS) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Returns whether the specified table column can be selected.

TableColumn: The table column.

Return true to permit selection, otherwise false.

The subclass can implement this event to disallow selection of particular columns.

NSTableViewMBS.shouldShowCellExpansion(tableColumn as NSTableColumnMBS, row as Int64) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Invoked to allow the subclass to control cell expansion for a specific row and column.

TableColumn: The table column.
row: The row index.

Return true if the tooltip cell should expand, false otherwise.

Cell expansion can occur when the mouse hovers over the specified cell and the cell contents are unable to be fully displayed within the cell. If this method returns true, the full cell contents will be shown in a special floating tool tip view, otherwise the content is truncated.

Note: This method is only valid for cell-based table views.

Available in Mac OS X v10.5 and later.

NSTableViewMBS.shouldTrackCell(cell as NSCellMBS, tableColumn as NSTableColumnMBS, row as Int64) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Invoked to allow the subclass to control the tracking behavior for a specific cell.

cell: The cell to track.
tableColumn: The table column.
row: A row in tableView.

Returns true if the cell should track, false otherwise.

Normally, only selectable or selected cells can be tracked. If you implement this method, cells which are not selectable or selected can be tracked, and vice-versa.

For example, this allows you to have an NSButtonCell in a table which does not change the selection, but can still be clicked on and tracked.

Note: This method is only valid for cell-based table views.

Available in Mac OS X v10.5 and later.

NSTableViewMBS.shouldTypeSelectForEvent(e as NSEventMBS, searchString as string) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Invoked to allow the subclass to control type select for a specific event.

event: The event.
searchString: The search string or nil if no type select has began.

Return true to allow type select for event, false otherwise.

Typically, this is called from the table view keyDown implementation and the event will be a key event.
Available in Mac OS X v10.5 and later.

NSTableViewMBS.sizeToFitWidthOfColumn(column as Int64) as Double

Type Topic Plugin Version macOS Windows Linux iOS Targets
event Cocoa Controls MBS MacControls Plugin 12.0 ✅ Yes ❌ No ❌ No ❌ No Desktop only
Invoked to allow the subclass to provide custom sizing behavior when a column's resize divider is double clicked.

column: The index of the column.

Returns the width of the specified column.

By default, NSTableView iterates every row in the table, accesses a cell via preparedCellAtColumn, and requests the cellSize to find the appropriate largest width to use.

For accurate results and performance, it is recommended that this method is implemented when using large tables. By default, large tables use a monte carlo simulation instead of iterating every row.

Available in Mac OS X v10.6 and later.

The items on this page are in the following plugins: MBS MacControls Plugin.


The biggest plugin in space...