Ссылка на протокол NSTableViewDelegate

Обеспечение представлений для строк и столбцов


    
    tableView (_: viewForTableColumn:row:)
    - tableView:viewForTableColumn:row:

Просит делегат к представлению отображать указанную строку и столбец.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, viewForTableColumn tableColumn: NSTableColumn?, row row: Int) -> NSView?

Objective C

- (NSView *)tableView:(NSTableView *)tableView viewForTableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы. (Если строка является строкой группы, `tableColumn` `nil`.)
`row`	Индекс строки.

Возвращаемое значение

Представление для отображения указанного столбца и строки. Если Вы возвращаетесь nil, представление не будет показано в том расположении.

Обсуждение

Если Вы хотите использовать, этот метод требуется NSView объекты вместо NSCell объекты для ячеек в табличном представлении. Ячейки и представления не могут быть смешаны в том же табличном представлении.

Рекомендуется, чтобы реализация этого метода сначала вызвала NSTableView метод makeViewWithIdentifier:owner: передача, соответственно, tableColumn идентификатор параметра и self как владелец, чтобы попытаться снова использовать представление, которое больше не видимо или автоматически разархивировало связанное прототипное представление для того идентификатора. frame из представления, возвращенного этим методом, не важно, и это будет автоматически установлено таблицей.

Свойства представления должны быть должным образом установлены прежде, чем возвратить результат.

Если по крайней мере один идентификатор был связан с табличным представлением во время проектирования, при использовании привязки Какао этот метод является дополнительным. (Обратите внимание на то, что идентификатор представления должен совпасть с идентификатором своего столбца. Простой способ достигнуть этого состоит в том, чтобы использовать Автоматическую установку идентификатора в Интерфейсном Разработчике.), Если этот метод не реализован, таблица автоматически вызовет NSTableView метод makeViewWithIdentifier:owner: с tableColumn идентификатор параметра и табличное представление delegate как параметры, чтобы попытаться снова использовать предыдущее представление, или автоматически разархивировать прототип связался с табличным представлением. Если этот метод реализован, можно установить свойства, не использующие привязку.

Маска автоизменения размеров возвращенного представления будет автоматически установлена в NSViewHeightSizable изменять размеры должным образом на изменениях высоты строки.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.


    
    tableView (_: rowViewForRow:)
    - tableView:rowViewForRow:

Просит делегат к представлению отображать указанную строку.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, rowViewForRow row: Int) -> NSTableRowView?

Objective C

- (NSTableRowView *)tableView:(NSTableView *)tableView rowViewForRow:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`row`	Индекс строки.

Возвращаемое значение

Экземпляр или подкласс NSTableRowView. Если nil возвращается, NSTableRowView экземпляр будет создаваться и использоваться.

Обсуждение

Делегат может реализовать этот метод для возврата пользовательского NSTableRowView для row.

Очередь повторного использования может использоваться таким же образом, как задокументировано в tableView:viewForTableColumn:row:. Возвращенное представление будет иметь атрибуты должным образом набором к нему, прежде чем это будет добавлено к tableView.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.

Уведомление о представлениях строки, добавляемых или удаленных


    
    tableView (_: didAddRowView:forRow:)
    - tableView:didAddRowView:forRow:

Говорит делегату, что представление строки было добавлено в указанной строке.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, didAddRowView rowView: NSTableRowView, forRow row: Int)

Objective C

- (void)tableView:(NSTableView *)tableView didAddRowView:(NSTableRowView *)rowView forRow:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`rowView`	Представление строки.
`row`	Индекс строки.

Обсуждение

В этой точке делегат может добавить дополнительные представления или изменить свойства rowView.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.


    
    tableView (_: didRemoveRowView:forRow:)
    - tableView:didRemoveRowView:forRow:

Говорит делегату, что представление строки было удалено из таблицы в указанной строке.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, didRemoveRowView rowView: NSTableRowView, forRow row: Int)

Objective C

- (void)tableView:(NSTableView *)tableView didRemoveRowView:(NSTableRowView *)rowView forRow:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`rowView`	Представление строки.
`row`	Индекс строки.

Обсуждение

Если row равняется -1, строка удаляется из таблицы и больше не является допустимой строкой; иначе row допустимая строка, удаляющаяся, будучи отъезжавшимся экран.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.7 и позже.

Группировка строк


    
    tableView (_: isGroupRow:)
    - tableView:isGroupRow:

Возвраты, является ли указанная строка строкой группы.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, isGroupRow row: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)tableView isGroupRow:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`row`	Индекс строки.

Возвращаемое значение

YEStrue если указанная строка должна иметь нарисованный стиль строки группы, NOfalse иначе.

Обсуждение

Если ячейка в row NSTextFieldCell и содержит только строку, атрибуты стиля строки группы будут автоматически применены к ячейке.

Строки группы в NSView- основанные табличные представления могут быть сделаны визуально «плавать» путем установки метода табличного представления setFloatsGroupRows: к YEStrue.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

См. также

floatsGroupRows (NSTableView)
setFloatsGroupRows: (NSTableView)

Обеспечение ячеек для строк и столбцов


    
    tableView (_: willDisplayCell:forTableColumn:row:)
    - tableView:willDisplayCell:forTableColumn:row:

Говорит делегату, что табличное представление выведет на экран указанную ячейку в указанной строке и столбце.

Объявление

Swift

optional func tableView(_ aTableView: NSTableView, willDisplayCell aCell: AnyObject, forTableColumn aTableColumn: NSTableColumn?, row rowIndex: Int)

Objective C

- (void)tableView:(NSTableView *)aTableView willDisplayCell:(id)aCell forTableColumn:(NSTableColumn *)aTableColumn row:(NSInteger)rowIndex

Параметры

`aTableView`	Табличное представление, отправившее сообщение.
`aCell`	Ячейка, которая будет выведена на экран.
`aTableColumn`	Столбец таблицы.
`rowIndex`	Индекс строки.

Обсуждение

Делегат может изменить атрибуты дисплея aCell изменить появление ячейки.

Поскольку aCell снова используется для каждой строки в aTableColumn, делегат должен установить атрибуты дисплея и при рисовании специальных ячеек и при рисовании стандартных ячеек.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: dataCellForTableColumn:row:)
    - tableView:dataCellForTableColumn:row:

Спрашивает делегат к пользовательской ячейке данных для указанной строки и столбца.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, dataCellForTableColumn tableColumn: NSTableColumn?, row row: Int) -> NSCell?

Objective C

- (NSCell *)tableView:(NSTableView *)tableView dataCellForTableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.
`row`	Индекс строки.

Возвращаемое значение

NSCell подкласс, использующийся для указанного row и tableColumn. Возвращенная ячейка должна должным образом реализовать copyWithZone:.

Обсуждение

Различная ячейка данных может быть возвращена для любого определенного столбца таблицы и строки или ячейки, которая будет использоваться для всей строки (т.е. полная ячейка ширины).

Если tableColumn не -nil, необходимо возвратить ячейку (обычно как результат отправки tableColumn a dataCellForRow: сообщение).

В то время как каждая строка рисуется, этот метод сначала вызывают с a tableColumn значение nil позволить Вам возвращать ячейку группы — т.е. ячейка, которая будет использоваться для рисования всей строки. Если Вы возвращаете ячейку когда tableColumn nil, весь реализованный источник данных и методы делегата должны быть подготовлены обработать a nil значение столбца таблицы. Если Вы не возвращаете ячейку, этот метод вызывают один раз для каждого tableColumn в tableView.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: shouldShowCellExpansionForTableColumn:row:)
    - tableView:shouldShowCellExpansionForTableColumn:row:

Если подсказка расширения должна быть выведена на экран для определенной строки и столбца, спрашивает делегат.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, shouldShowCellExpansionForTableColumn tableColumn: NSTableColumn?, row row: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)tableView shouldShowCellExpansionForTableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.
`row`	Индекс строки.

Возвращаемое значение

YEStrue если подсказка расширения должна быть выведена на экран, NOfalse иначе.

Обсуждение

Подсказка расширения может быть выведена на экран, когда указатель нависает над ячейкой, содержащей усеченный текст. Когда возвращается этот метод YEStrue, полное содержание ячейки показано в подсказке расширения, выглядящей подобной тегу справки.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: toolTipForCell:rect:tableColumn:row:mouseLocation:)
    - tableView:toolTipForCell:rect:tableColumn:row:mouseLocation:

Просит делегат к строке отображать в подсказке для указанной ячейки в столбце и строке.

Объявление

Swift

optional func tableView(_ aTableView: NSTableView, toolTipForCell aCell: NSCell, rect rect: NSRectPointer, tableColumn aTableColumn: NSTableColumn?, row row: Int, mouseLocation mouseLocation: NSPoint) -> String

Objective C

- (NSString *)tableView:(NSTableView *)aTableView toolTipForCell:(NSCell *)aCell rect:(NSRectPointer)rect tableColumn:(NSTableColumn *)aTableColumn row:(NSInteger)row mouseLocation:(NSPoint)mouseLocation

Параметры

`aTableView`	Табличное представление, отправившее сообщение.
`aCell`	Ячейка.
`rect`	Предложенная активная область подсказки. Можно изменить `rect` обеспечить альтернативную активную область.
`aTableColumn`	Столбец таблицы.
`row`	Индекс строки.
`mouseLocation`	Расположение мыши.

Возвращаемое значение

Строка, которая должна быть выведена на экран в подсказке. Возвратиться nil или пустая строка, если не желаема никакая подсказка.

Обсуждение

По умолчанию, rect вычислен как [cell drawingRectForBounds:cellFrame]. Обратите внимание на то, что подсказки также известны как теги справки.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.4 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

Редактирование ячеек


    
    tableView (_: shouldEditTableColumn:row:)
    - tableView:shouldEditTableColumn:row:

Если ячейка в указанной строке и столбце может быть отредактирована, спрашивает делегат.

Объявление

Swift

optional func tableView(_ aTableView: NSTableView, shouldEditTableColumn aTableColumn: NSTableColumn?, row rowIndex: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)aTableView shouldEditTableColumn:(NSTableColumn *)aTableColumn row:(NSInteger)rowIndex

Параметры

`aTableView`	Табличное представление, отправившее сообщение.
`aTableColumn`	Столбец таблицы.
`rowIndex`	Индекс строки.

Возвращаемое значение

YEStrue позволить редактировать ячейку, NOfalse отрицать редактировать.

Обсуждение

Делегат может реализовать этот метод для запрещения редактирования определенных ячеек.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

Установка строки и размера столбца


    
    tableView (_: heightOfRow:)
    - tableView:heightOfRow:

Спрашивает делегат к высоте указанной строки.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, heightOfRow row: Int) -> CGFloat

Objective C

- (CGFloat)tableView:(NSTableView *)tableView heightOfRow:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`row`	Индекс строки.

Возвращаемое значение

Высота строки. Высота не должна включать интервал межъячейки и должна быть больше, чем нуль.

Обсуждение

Необходимо реализовать этот метод если табличные поддержки переменные высоты строки.

Несмотря на то, что табличные представления могут кэшировать возвращенные значения, необходимо гарантировать, что этот метод эффективен. При изменении высоты строки, необходимо лишить законной силы существующую высоту строки путем вызова noteHeightOfRowsWithIndexesChanged:. NSTableView автоматически лишает законной силы его весь кэш высоты строки когда reloadData и noteNumberOfRowsChanged вызываются.

Если Вы вызываете viewAtColumn:row:makeIfNecessary: или rowViewAtRow:makeIfNecessary: в Вашей реализации этого метода выдается исключение.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.4 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: sizeToFitWidthOfColumn:)
    - tableView:sizeToFitWidthOfColumn:

Просит делегат обеспечивать пользовательское поведение калибровки, когда столбец изменяет размеры делителя, дважды щелкнут.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, sizeToFitWidthOfColumn column: Int) -> CGFloat

Objective C

- (CGFloat)tableView:(NSTableView *)tableView sizeToFitWidthOfColumn:(NSInteger)column

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`column`	Индекс столбца.

Возвращаемое значение

Ширина указанного столбца.

Обсуждение

По умолчанию, NSTableView выполняет итерации каждой строки в таблице, получает доступ к ячейке через preparedCellAtColumn:row:, и запросы cellSize найти, что надлежащая самая большая ширина использует.

Для точных результатов и производительности, рекомендуется, чтобы этот метод был реализован при использовании больших таблиц. По умолчанию большие таблицы используют моделирование Монте-Карло вместо того, чтобы выполнить итерации каждой строки.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.

Выбор строк

selectionShouldChangeInTableView (_:) - selectionShouldChangeInTableView:

Если пользователю разрешают изменить выбор, спрашивает делегат.

Объявление

Swift

optional func selectionShouldChangeInTableView(_ aTableView: NSTableView) -> Bool

Objective C

- (BOOL)selectionShouldChangeInTableView:(NSTableView *)aTableView

Параметры

aTableView

Табличное представление, отправившее сообщение.

Возвращаемое значение

YEStrue позволить табличному представлению изменять свой выбор (обычно отредактированная строка), NOfalse отклонять изменение выбора.

Обсуждение

Пользователь может выбрать и отредактировать различные ячейки в той же строке, но не может выбрать другую строку, если не утверждает делегат. Делегат может реализовать этот метод для сложной проверки отредактированных строк на основе значений любой из их ячеек.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: shouldSelectRow:)
    - tableView:shouldSelectRow:

Если табличное представление должно позволить выбор указанной строки, спрашивает делегат.

Объявление

Swift

optional func tableView(_ aTableView: NSTableView, shouldSelectRow rowIndex: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)aTableView shouldSelectRow:(NSInteger)rowIndex

Параметры

`aTableView`	Табличное представление, отправившее сообщение.
`rowIndex`	Индекс строки.

Возвращаемое значение

YEStrue разрешать выбор строки, NOfalse отклонять выбор.

Обсуждение

Делегат может реализовать этот метод для запрещения выбора определенных строк.

Для лучшей производительности и управления более прекрасной мелкой частицы выбором, использовать tableView:selectionIndexesForProposedSelection:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: selectionIndexesForProposedSelection:)
    - tableView:selectionIndexesForProposedSelection:

Просит делегат принимать или отклонять предложенный выбор.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, selectionIndexesForProposedSelection proposedSelectionIndexes: NSIndexSet) -> NSIndexSet

Objective C

- (NSIndexSet *)tableView:(NSTableView *)tableView selectionIndexesForProposedSelection:(NSIndexSet *)proposedSelectionIndexes

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`proposedSelectionIndexes`	Индексный набор, содержащий индексы предложенного выбора.

Возвращаемое значение

NSIndexSet экземпляр, содержащий индексы нового выбора. Возвратиться proposedSelectionIndexes если предложенный выбор приемлем, или значение существующего выбора табличного представления, чтобы избежать изменять выбор.

Обсуждение

Этот метод можно вызвать многократно с одним новым индексом, добавленным к существующему выбору, чтобы узнать, может ли определенный индекс быть выбран, когда пользователь расширяет выбор с помощью клавиатуры или мыши.

Если реализовано, вместо этого метода вызовут tableView:shouldSelectRow:.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: shouldSelectTableColumn:)
    - tableView:shouldSelectTableColumn:

Спрашивает делегат, может ли быть выбран указанный столбец таблицы.

Объявление

Swift

optional func tableView(_ aTableView: NSTableView, shouldSelectTableColumn aTableColumn: NSTableColumn?) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)aTableView shouldSelectTableColumn:(NSTableColumn *)aTableColumn

Параметры

`aTableView`	Табличное представление, отправившее сообщение.
`aTableColumn`	Столбец таблицы.

Возвращаемое значение

YEStrue разрешать выбор, иначе NOfalse.

Обсуждение

Делегат может реализовать этот метод для запрещения выбора определенных столбцов.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

tableViewSelectionIsChanging (_:) - tableViewSelectionIsChanging:

Говорит делегату, что выбор табличного представления находится в процессе изменения.

Объявление

Swift

optional func tableViewSelectionIsChanging(_ aNotification: NSNotification)

Objective C

- (void)tableViewSelectionIsChanging:(NSNotification *)aNotification

Параметры

aNotification

Уведомление называют NSTableViewSelectionIsChangingNotification.

Обсуждение

Этот метод вызывают только, когда события от нажатия мыши — и не события клавиатуры — изменяют выбор. Например, когда пользователь перетаскивает мышь через многократные строки таблицы, этот метод вызывают.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
tableViewSelectionDidChange (_:) - tableViewSelectionDidChange:

Говорит делегату, что изменился выбор табличного представления.

Объявление

Swift

optional func tableViewSelectionDidChange(_ aNotification: NSNotification)

Objective C

- (void)tableViewSelectionDidChange:(NSNotification *)aNotification

Параметры

aNotification

Уведомление называют NSTableViewSelectionDidChangeNotification.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: shouldTypeSelectForEvent:withCurrentSearchString:)
    - tableView:shouldTypeSelectForEvent:withCurrentSearchString:

Просит делегат позволять или отклонять выбор типа для указанного события и текущей строки поиска.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, shouldTypeSelectForEvent event: NSEvent, withCurrentSearchString searchString: String?) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)tableView shouldTypeSelectForEvent:(NSEvent *)event withCurrentSearchString:(NSString *)searchString

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`event`	Событие.
`searchString`	Строка поиска или `nil` если никакой выбор типа не имеет, начался.

Возвращаемое значение

YES для разрешения типа выбирает для события, НЕТ иначе.

Обсуждение

Как правило, это вызывают от табличного представления keyDown: реализация и событие будут ключевым событием.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: typeSelectStringForTableColumn:row:)
    - tableView:typeSelectStringForTableColumn:row:

Просит делегат обеспечивать значение альтернативного текста, используемое для выбора типа для указанной строки и столбца.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, typeSelectStringForTableColumn tableColumn: NSTableColumn?, row row: Int) -> String?

Objective C

- (NSString *)tableView:(NSTableView *)tableView typeSelectStringForTableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.
`row`	Индекс строки.

Возвращаемое значение

Строка, использующаяся в сравнении выбора типа для row и tableColumn. Возвратиться nil если row или tableColumn не должен искаться.

Обсуждение

Реализуйте этот метод для изменения строкового значения, разыскивающегося на основе того, что выведено на экран. По умолчанию все ячейки с текстом в них ищутся.

Если этот метод делегата не реализован, строковое значение по умолчанию (который может также быть возвращен из метода делегата):

      [[tableView preparedCellAtColumn:tableColumn row:row] stringValue]

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: nextTypeSelectMatchFromRow:toRow:forString:)
    - tableView:nextTypeSelectMatchFromRow:toRow:forString:

Спрашивает делегат к строке в указанном поисковом диапазоне, соответствующем указанную строку.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, nextTypeSelectMatchFromRow startRow: Int, toRow endRow: Int, forString searchString: String) -> Int

Objective C

- (NSInteger)tableView:(NSTableView *)tableView nextTypeSelectMatchFromRow:(NSInteger)startRow toRow:(NSInteger)endRow forString:(NSString *)searchString

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`startRow`	Стартовая строка поискового диапазона.
`endRow`	Конечная строка поискового диапазона.
`searchString`	Строка, содержащая введенный выбор.

Возвращаемое значение

Первая строка в диапазоне startRow через endRow (исключая endRow самостоятельно), который соответствует selectionString. Возвратитесь-1, если не найдено никакое соответствие.

Обсуждение

Используйте этот метод, чтобы управлять, как выбор типа работает в таблице. (Реализация этого метода не требуется, чтобы выбор типа поддержки.) Обратите внимание на то, что это возможно для endRow быть меньше, чем startRow если перенесется поиск.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

Перемещение и изменение размеров столбцов


    
    tableView (_: shouldReorderColumn:toColumn:)
    - tableView:shouldReorderColumn:toColumn:

Просит делегат позволять или запрещать, что указанный столбец перетаскивается к новому расположению.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, shouldReorderColumn columnIndex: Int, toColumn newColumnIndex: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)tableView shouldReorderColumn:(NSInteger)columnIndex toColumn:(NSInteger)newColumnIndex

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`columnIndex`	Индекс перетаскиваемого столбца.
`newColumnIndex`	Предложенный целевой индекс столбца.

Возвращаемое значение

YEStrue если переупорядочение столбца должно быть позволено, иначе NOfalse.

Обсуждение

Когда столбец первоначально перетаскивается пользователем, делегата сначала вызывают с a newColumnIndex значение -1. Возврат NOfalse запретит тот столбец от того, чтобы быть переупорядоченным вообще. Возврат YEStrue позволяет ему быть переупорядоченным, и делегата вызовут снова, когда столбец достигнет нового расположения.

Фактическое NSTableColumn экземпляр может быть получен от tableColumns массив.

Если этот метод не реализован, все столбцы считают reorderable.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.6 и позже.


    
    tableView (_: didDragTableColumn:)
    - tableView:didDragTableColumn:

Говорит делегату, что был перетащен указанный столбец таблицы.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, didDragTableColumn tableColumn: NSTableColumn)

Objective C

- (void)tableView:(NSTableView *)tableView didDragTableColumn:(NSTableColumn *)tableColumn

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.

Специальные замечания

В частности, когда кнопка мыши восстанавливает работоспособность в, этот метод отправляется tableView и tableColumn был перетащен в течение времени, на которое снизилась кнопка мыши. На OS X v 10.5 и позже перетащенный столбец отправляется делегату. (В более ранних версиях OS X отправляется столбец таблицы, это в настоящее время располагается в исходном индексе перетащенного столбца.)

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.

tableViewColumnDidMove (_:) - tableViewColumnDidMove:

Говорит делегату, что столбец таблицы был перемещен пользовательским действием.

Объявление

Swift

optional func tableViewColumnDidMove(_ aNotification: NSNotification)

Objective C

- (void)tableViewColumnDidMove:(NSNotification *)aNotification

Параметры

aNotification

Уведомление называют NSTableViewColumnDidMoveNotification.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.
tableViewColumnDidResize (_:) - tableViewColumnDidResize:

Говорит делегату, что был изменен tablecolumn.

Объявление

Swift

optional func tableViewColumnDidResize(_ aNotification: NSNotification)

Objective C

- (void)tableViewColumnDidResize:(NSNotification *)aNotification

Параметры

aNotification

Уведомление называют NSTableViewColumnDidResizeNotification.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.
Доступный как часть неофициального протокола до OS X v10.6.

Ответ на события от нажатия мыши


    
    tableView (_: didClickTableColumn:)
    - tableView:didClickTableColumn:

Говорит делегату, что кнопкой мыши щелкнули в указанном столбце таблицы, но не был перетащен столбец.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, didClickTableColumn tableColumn: NSTableColumn)

Objective C

- (void)tableView:(NSTableView *)tableView didClickTableColumn:(NSTableColumn *)tableColumn

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: mouseDownInHeaderOfTableColumn:)
    - tableView:mouseDownInHeaderOfTableColumn:

Говорит делегату, что кнопкой мыши щелкнули в заголовке указанного столбца таблицы.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, mouseDownInHeaderOfTableColumn tableColumn: NSTableColumn)

Objective C

- (void)tableView:(NSTableView *)tableView mouseDownInHeaderOfTableColumn:(NSTableColumn *)tableColumn

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`tableColumn`	Столбец таблицы.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.0 и позже.

Доступный как часть неофициального протокола до OS X v10.6.


    
    tableView (_: shouldTrackCell:forTableColumn:row:)
    - tableView:shouldTrackCell:forTableColumn:row:

Спрашивает делегат, должна ли быть прослежена указанная ячейка.

Объявление

Swift

optional func tableView(_ tableView: NSTableView, shouldTrackCell cell: NSCell, forTableColumn tableColumn: NSTableColumn?, row row: Int) -> Bool

Objective C

- (BOOL)tableView:(NSTableView *)tableView shouldTrackCell:(NSCell *)cell forTableColumn:(NSTableColumn *)tableColumn row:(NSInteger)row

Параметры

`tableView`	Табличное представление, отправившее сообщение.
`cell`	Ячейка для отслеживания.
`tableColumn`	Столбец таблицы.
`row`	Строка в `tableView`.

Возвращаемое значение

YEStrue если ячейка должна быть прослежена, NOfalse иначе.

Обсуждение

В целом только выбираемые или выбранные ячейки могут быть прослежены. При реализации этого метода ячейки, не можно выбрать или не выбранные, могут быть прослежены; точно так же ячейки, можно выбрать или выбранные, могут быть установлены как неотслеженные.

Например, это позволяет Вам иметь NSButtonCell в таблице, которая не изменяет выбор, но может все еще щелкнуться и прослежена.

Оператор импорта

Objective C

@import AppKit;

Swift

import AppKit

Доступность

Доступный в OS X v10.5 и позже.

Доступный как часть неофициального протокола до OS X v10.6.