Platforms to show: All Mac Windows Linux Cross-Platform
Back to NSTableViewMBS class.
NSTableViewMBS.allowsColumnReordering as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default is true. You can rearrange columns programmatically regardless of this setting.
(Read and Write property)
NSTableViewMBS.allowsColumnResizing as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
(Read and Write property)
NSTableViewMBS.allowsColumnSelection as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default is false. You can select columns programmatically regardless of this setting.
(Read and Write property)
NSTableViewMBS.allowsEmptySelection as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Unlike with the other settings that affect selection behavior, you cannot set an empty selection programmatically if empty selection is disallowed.
(Read and Write property)
NSTableViewMBS.allowsMultipleSelection as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default is false. You can select multiple columns or rows programmatically regardless of this setting.
(Read and Write property)
NSTableViewMBS.allowsTypeSelect as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Available in Mac OS X v10.5 and later.
(Read and Write property)
Some examples using this property:
NSTableViewMBS.autosaveName as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.6 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The table information is saved separately for each user and for each application that user uses.
Note that even when a table view has an autosave name, it may not be saving table information automatically.
(Read and Write property)
NSTableViewMBS.autosaveTableColumns as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
If flag is different from the current value, this method also reads in the saved information and sets the table options to match.
The table information is saved separately for each user and for each application that user uses. Note that if autosaveName returns nil, this setting is ignored and table information isn't saved.
(Read and Write property)
NSTableViewMBS.backgroundColor as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default background color is light gray.
(Read and Write property)
NSTableViewMBS.clickedColumn as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The index of the column the user clicked to trigger an action message. Returns –1 if the user clicked in an area of the table view not occupied by columns.
Index is zero based.
(Read only property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
NSTableViewMBS.clickedRow as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The index of the row the user clicked to trigger an action message. Returns –1 if the user clicked in an area of the table view not occupied by table rows.
Index is zero based.
(Read only property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
- /MacControls/Listbox and TableView Demos/NSOutlineView/Disk Browser
NSTableViewMBS.columnAutoresizingStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Use the following constants:
NSTableViewMBS.kFirstColumnOnlyAutoresizingStyle
NSTableViewMBS.kUniformColumnAutoresizingStyle
NSTableViewMBS.kSequentialColumnAutoresizingStyle
NSTableViewMBS.kReverseSequentialColumnAutoresizingStyle
NSTableViewMBS.kNoColumnAutoresizing
NSTableViewMBS.kLastColumnOnlyAutoresizingStyle
Available in Mac OS X v10.4 and later.
(Read and Write property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
- /MacControls/Listbox and TableView Demos/NSOutlineView/Disk Browser
NSTableViewMBS.cornerView as NSViewMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
This is by default a simple view that merely fills in its frame, but you can replace it with a custom view using this property.
(Read and Write property)
NSTableViewMBS.dataSource as NSTableDataSourceMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
(Read and Write property)
NSTableViewMBS.draggingDestinationFeedbackStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.6 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Available in Mac OS X v10.6 and later.
(Read and Write property)
NSTableViewMBS.editedColumn as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
First column has index zero.
If sent during editColumn(), the index of the row being edited; otherwise –1.
(Read only property)
NSTableViewMBS.editedRow as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The first row index is zero.
If sent during editColumn(), the index of the row being edited; otherwise –1.
(Read only property)
NSTableViewMBS.effectiveRowSizeStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 13.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
If the rowSizeStyle is NSTableViewRowSizeStyleDefault, then this method returns the default size for this table.
The default size is currently set in the System Preferences by the users.
Available in OS X v10.7 and later.
(Read only property)
NSTableViewMBS.effectiveStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 21.0 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Otherwise, it returns the same value as style.
(Read only property)
NSTableViewMBS.floatsGroupRows as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Group rows are rows for which the table view delegate’s isGroupRow method returns true. These rows can be displayed as if they are floating in a view-based table view.
The default value of this property is true.
(Read and Write property)
NSTableViewMBS.focusedColumn as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.6 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Returns the index of the column, or -1 if there is no focused column
The focus interaction will always be on the selectedRow of the table. If the selectedRow is a full width cell, then focusedColumn will return 1 when focused..
Available in Mac OS X v10.6 and later.
(Read and Write property)
NSTableViewMBS.gridColor as NSColorMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default color is gray.
(Read and Write property)
NSTableViewMBS.gridStyleMask as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
use the constants;
kGridNone | = 0, |
kSolidVerticalGridLineMask | = 1 |
kSolidHorizontalGridLineMask | = 2 |
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
- /MacControls/Listbox and TableView Demos/NSOutlineView/Disk Browser
- /MacControls/Listbox and TableView Demos/NSOutlineView/OutlineControl
- /MacControls/Outline View Test
- /MacControls/TableControl
- /MacFrameworks/Cocoa Controls/TableView
- /MacFrameworks/Cocoa Controls/TableView with scrollbars
NSTableViewMBS.headerView as NSTableHeaderViewMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.6 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The NSTableHeaderView object used to draw headers over columns, or nil if the receiver has no header view
(Read and Write property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
NSTableViewMBS.highlightedtableColumn as NSTableColumnMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
A highlightable column header can be used in conjunction with row selection to highlight a particular column of the table. An example of this is how the Mail application indicates the currently sorted column.
(Read and Write property)
NSTableViewMBS.intercellSpacing as NSSizeMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 9.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default spacing is (3.0, 2.0).
(Read and Write property)
NSTableViewMBS.numberOfColumns as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The value returned includes table columns that are currently hidden.
(Read only property)
NSTableViewMBS.numberOfRows as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Typically you should not ask the table view how many rows it has; instead you should interrogate the table view's data source.
(Read only property)
NSTableViewMBS.numberOfSelectedColumns as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
(Read only property)
NSTableViewMBS.numberOfSelectedRows as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
(Read only property)
NSTableViewMBS.rowActionsVisible as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
This property contains a Boolean value indicating whether a table row’s actions are visible or not—the user has swiped the row to reveal the row actions. Set the value of this property to false to hide any visible row actions. Setting the value of this property to true is not supported, and will result in an exception.
(Read and Write property)
NSTableViewMBS.rowHeight as Double
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The default row height is 16.0.
(Read and Write property)
NSTableViewMBS.rowSizeStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 13.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The row size style can be modified on a row by row basis by invoking the event heightOfRow, if implemented.
The rowSizeStyle defaults to NSTableViewRowSizeStyleCustom. NSTableViewRowSizeStyleCustom indicates to use the rowHeight of the table, instead of the pre-determined system values.
Generally, rowSizeStyle should always be NSTableViewRowSizeStyleCustom except for "source lists". To implement variable row heights, set the value to NSTableViewRowSizeStyleCustom and implement tableView:heightOfRow: in the delegate.
Available in OS X v10.7 and later.
(Read and Write property)
NSTableViewMBS.selectedColumn as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Returns the index of the last column selected or added to the selection, or –1 if no column is selected.
(Read only property)
NSTableViewMBS.selectedRow as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Returns the index of the last row selected or added to the selection, or –1 if no row is selected.
(Read only property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Database with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV Simple Demo with DataSource
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListboxTV with ContainerControl Cells
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
NSTableViewMBS.selectionHighlightStyle as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Available in Mac OS X v10.5 and later.
(Read and Write property)
NSTableViewMBS.style as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 21.0 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Defaults to NSTableViewStyleAutomatic.
For macOS 11.0 or newer.
Available styles:
NSTableViewStyleFullWidth | The table view style resolves to a full-width style. |
NSTableViewStyleInset | The table view style resolves to an inset style. |
NSTableViewStyleSourceList | The table view style resolves to a source-list style. |
NSTableViewStylePlain | The table view style resolves to a plain style. |
NSTableViewMBS.usesAlternatingRowBackgroundColors as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Available in Mac OS X v10.3 and later.
(Read and Write property)
Some examples using this property:
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Flat Only/ListBoxTV TableView
- /MacControls/Listbox and TableView Demos/ListboxTV drop-in/Hierarchical & Flat/ListBoxTV OutlineView
- /MacControls/Listbox and TableView Demos/NSOutlineView/Disk Browser
- /MacControls/Listbox and TableView Demos/NSOutlineView/OutlineControl
- /MacControls/Outline View Test
- /MacControls/TableControl
- /MacFrameworks/Cocoa Controls/TableView
- /MacFrameworks/Cocoa Controls/TableView with scrollbars
NSTableViewMBS.usesStaticContents as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 17.1 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
A static table does not rely on a data source to provide the number of rows. A static table view’s contents are set at design time and can be changed programmatically as needed. Typically, you do not change the contents of a static table view after setting them.
In Xcode, any rows you add to a static table are saved in the corresponding nib or storyboard file and loaded with the rest of the table at runtime. You can add table rows programmatically to a static table view using the insertRowsAtIndexes method. When adding rows programmatically, your table view delegate must implement the view method to provide the corresponding view for any new rows. You can also remove rows at any time using the removeRowsAtIndexes method.
A table with static contents must be an NSView-based table view.
Available in macOS 10.10 or later.
(Read and Write property)
NSTableViewMBS.verticalMotionCanBeginDrag as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | Cocoa Controls | MBS MacControls Plugin | 8.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
If flag is false then vertical motion will not start a drag. The default is true.
Note that horizontal motion is always a valid motion to begin a drag. Most often, you would want to disable vertical dragging when it's expected that horizontal dragging is the natural motion.
(Read and Write property)
The items on this page are in the following plugins: MBS MacControls Plugin.