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

Расширение и разрушение схемы


    
    outlineView (_: shouldExpandItem:)
    - outlineView:shouldExpandItem:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldExpandItem item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldExpandItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент, который должен расшириться.

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

YEStrue разрешать outlineView расшириться item, NOfalse отклонять разрешение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: shouldCollapseItem:)
    - outlineView:shouldCollapseItem:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldCollapseItem item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldCollapseItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент, который должен разрушиться.

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

YEStrue разрешать outlineView разрушиться item, NOfalse отклонять разрешение.

Обсуждение

Делегат может реализовать этот метод для запрещения разрушения конкретных изделий. Например, если первая строка Вашего представления схемы не должна быть разрушена, Ваш метод делегата мог бы содержать эту строку кода:

      return [outlineView rowForItem:item]!=0;

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Поддержка выбора типа


    
    outlineView (_: typeSelectStringForTableColumn:item:)
    - outlineView:typeSelectStringForTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, typeSelectStringForTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> String?

Objective C

- (NSString *)outlineView:(NSOutlineView *)outlineView typeSelectStringForTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы в представлении схемы.
`item`	Элемент в представлении схемы.

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

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

Обсуждение

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

Значение по умолчанию, когда этот метод делегата не реализован:

      [[outlineView preparedCellAtColumn:tableColumn row:[outlineView rowForItem:item]] stringValue]

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: nextTypeSelectMatchFromItem:toItem:forString:)
    - outlineView:nextTypeSelectMatchFromItem:toItem:forString:

Возвращает первый элемент, соответствующий searchString из диапазона startItem к конечному продукту

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, nextTypeSelectMatchFromItem startItem: AnyObject, toItem endItem: AnyObject, forString searchString: String) -> AnyObject?

Objective C

- (id)outlineView:(NSOutlineView *)outlineView nextTypeSelectMatchFromItem:(id)startItem toItem:(id)endItem forString:(NSString *)searchString

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`startItem`	Первый элемент, который будет искать.
`endItem`	Элемент, перед которым можно прекратить искать. Если поиск перенесется, для конечного продукта возможно быть меньше, чем startItem.
`searchString`	Строка, которую можно искать.

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

Первый элемент — из диапазона startItem к endItem— это соответствует searchString, или nil если там не идет ни в какое сравнение.

Обсуждение

Реализуйте этот метод, если Вы хотите управлять, как работает выбор типа. Необходимо включать startItem как возможное соответствие, но не включают endItem.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: shouldTypeSelectForEvent:withCurrentSearchString:)
    - outlineView:shouldTypeSelectForEvent:withCurrentSearchString:

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

Объявление

Swift

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

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldTypeSelectForEvent:(NSEvent *)event withCurrentSearchString:(NSString *)searchString

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`event`	Событие, заставившее сообщение быть отправленным.
`searchString`	Строка, для которой должен продолжиться поиск. Строка поиска `nil` если не начался никакой выбор типа.

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

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

Обсуждение

Обычно от этого метода вызовут keyDown: и событие будет ключевым событием.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Работа с подсказками


    
    outlineView (_: toolTipForCell:rect:tableColumn:item:mouseLocation:)
    - outlineView:toolTipForCell:rect:tableColumn:item:mouseLocation:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, toolTipForCell cell: NSCell, rect rect: NSRectPointer, tableColumn tc: NSTableColumn?, item item: AnyObject, mouseLocation mouseLocation: NSPoint) -> String

Objective C

- (NSString *)outlineView:(NSOutlineView *)outlineView toolTipForCell:(NSCell *)cell rect:(NSRectPointer)rect tableColumn:(NSTableColumn *)tc item:(id)item mouseLocation:(NSPoint)mouseLocation

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`cell`	Ячейка, для которой можно генерировать подсказку.
`rect`	Предложенная активная область подсказки. Для управления активной областью по умолчанию можно изменить `rect` параметр. По умолчанию, `rect` вычислен как `[cell drawingRectForBounds:cellFrame]`.
`tc`	Содержащий столбец таблицы `cell`.
`item`	Элемент, для которого можно вывести на экран подсказку.
`mouseLocation`	Текущее расположение мыши в поле зрения координирует.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Обработка выбора


    
    outlineView (_: shouldSelectTableColumn:)
    - outlineView:shouldSelectTableColumn:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldSelectTableColumn tableColumn: NSTableColumn?) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldSelectTableColumn:(NSTableColumn *)tableColumn

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: shouldSelectItem:)
    - outlineView:shouldSelectItem:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldSelectItem item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldSelectItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент.

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

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

Обсуждение

Вы реализуете этот метод для запрещения выбора определенных элементов.

Для лучшей производительности и более прекрасного гранулярного управления выбором, использовать outlineView:dataCellForTableColumn:item:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: selectionIndexesForProposedSelection:)
    - outlineView:selectionIndexesForProposedSelection:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, selectionIndexesForProposedSelection proposedSelectionIndexes: NSIndexSet) -> NSIndexSet

Objective C

- (NSIndexSet *)outlineView:(NSOutlineView *)outlineView selectionIndexesForProposedSelection:(NSIndexSet *)proposedSelectionIndexes

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`proposedSelectionIndexes`	Индексный набор, содержащий индексы предложенного выбора.

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

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

Обсуждение

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

Реализация этого метода является дополнительной. Если реализовано, вместо этого метода вызовут outlineView:willDisplayOutlineCell:forTableColumn:item:.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

selectionShouldChangeInOutlineView (_:) - selectionShouldChangeInOutlineView:

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

Объявление

Swift

optional func selectionShouldChangeInOutlineView(_ outlineView: NSOutlineView) -> Bool

Objective C

- (BOOL)selectionShouldChangeInOutlineView:(NSOutlineView *)outlineView

Параметры

outlineView

Представление схемы, отправившее сообщение.

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

YEStrue разрешать outlineView изменить его выбор (обычно отредактированная строка), NOfalse отклонять разрешение.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Вызванный, когда notification отправляется — т.е. каждый раз, когда изменяется выбор представления схемы.

Объявление

Swift

optional func outlineViewSelectionIsChanging(_ notification: NSNotification)

Objective C

- (void)outlineViewSelectionIsChanging:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewSelectionIsChangingNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

optional func outlineViewSelectionDidChange(_ notification: NSNotification)

Objective C

- (void)outlineViewSelectionDidChange:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewSelectionDidChangeNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Отображение ячеек


    
    outlineView (_: willDisplayCell:forTableColumn:item:)
    - outlineView:willDisplayCell:forTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, willDisplayCell cell: AnyObject, forTableColumn tableColumn: NSTableColumn?, item item: AnyObject)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView willDisplayCell:(id)cell forTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`cell`	Ячейка.
`tableColumn`	Столбец таблицы.
`item`	Элемент.

Обсуждение

Делегат может реализовать этот метод для изменения cell обеспечить дальнейшую установку для cell в tableColumn и item. Не безопасно сделать получение в этом методе — необходимо только установить работоспособное состояние для cell.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: willDisplayOutlineCell:forTableColumn:item:)
    - outlineView:willDisplayOutlineCell:forTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, willDisplayOutlineCell cell: AnyObject, forTableColumn tableColumn: NSTableColumn?, item item: AnyObject)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView willDisplayOutlineCell:(id)cell forTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`cell`	Ячейка.
`tableColumn`	Столбец таблицы.
`item`	Элемент.

Обсуждение

Сообщает делегату это outlineView собирается вывести на экран cell— расширяемая ячейка (ячейка, имеющая символ расширения) — для столбца и элемента, указанного tableColumn и item. Делегат может изменить ячейку для изменения ее атрибутов дисплея.

Этот метод не вызывается когда outlineView собирается вывести на экран нерасширяемую ячейку.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: dataCellForTableColumn:item:)
    - outlineView:dataCellForTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, dataCellForTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> NSCell?

Objective C

- (NSCell *)outlineView:(NSOutlineView *)outlineView dataCellForTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы, для которого требуется ячейка. Это значение может быть `nil`.
`item`	Элемент, для которого требуется ячейка.

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

Ячейка для использования в столбце tableColumn для элемента item, или nil. Ячейка должна должным образом реализовать copyWithZone: (так как это может быть скопировано представлением схемы).

Обсуждение

Можно возвратить различную ячейку данных для любой определенной комбинации столбца таблицы и элемента или ячейки, которая будет использоваться для всей строки (полноширинная ячейка). Если tableColumn не -nil, необходимо возвратить ячейку. Как правило, необходимо принять значение по умолчанию к возврату результата [tableColumn dataCellForRow:row].

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: shouldShowOutlineCellForItem:)
    - outlineView:shouldShowOutlineCellForItem:

Возвращается, должен ли указанный элемент вывести на экран ячейку схемы (треугольник раскрытия).

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldShowOutlineCellForItem item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldShowOutlineCellForItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент в представлении схемы.

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

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

Обсуждение

Возврат NOfalse причины frameOfOutlineCellAtRow: возвратиться NSZeroRect, сокрытие ячейки. Кроме того, строка не будет разборной сочетаниями клавиш.

Этот метод вызывают только для расширяемых строк.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    outlineView (_: shouldShowCellExpansionForTableColumn:item:)
    - outlineView:shouldShowCellExpansionForTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldShowCellExpansionForTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldShowCellExpansionForTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы в представлении схемы.
`item`	Элемент в представлении схемы.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

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


    
    outlineView (_: shouldReorderColumn:toColumn:)
    - outlineView:shouldReorderColumn:toColumn:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldReorderColumn columnIndex: Int, toColumn newColumnIndex: Int) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldReorderColumn:(NSInteger)columnIndex toColumn:(NSInteger)newColumnIndex

Параметры

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

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

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

Обсуждение

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

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Работа со столбцом схемы

outlineViewColumnDidMove (_:) - outlineViewColumnDidMove:

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

Объявление

Swift

optional func outlineViewColumnDidMove(_ notification: NSNotification)

Objective C

- (void)outlineViewColumnDidMove:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewColumnDidMoveNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

optional func outlineViewColumnDidResize(_ notification: NSNotification)

Objective C

- (void)outlineViewColumnDidResize:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewColumnDidResizeNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Вызванный, когда notification отправляется — т.е. каждый раз, когда пользователь собирается развернуть элемент в представлении схемы.

Объявление

Swift

optional func outlineViewItemWillExpand(_ notification: NSNotification)

Objective C

- (void)outlineViewItemWillExpand:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewItemWillExpandNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

optional func outlineViewItemDidExpand(_ notification: NSNotification)

Objective C

- (void)outlineViewItemDidExpand:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewItemDidExpandNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Вызванный, когда notification отправляется — т.е. каждый раз, когда пользователь собирается упасть в обморок элемент в представлении схемы.

Объявление

Swift

optional func outlineViewItemWillCollapse(_ notification: NSNotification)

Objective C

- (void)outlineViewItemWillCollapse:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewItemWillCollapseNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Объявление

Swift

optional func outlineViewItemDidCollapse(_ notification: NSNotification)

Objective C

- (void)outlineViewItemDidCollapse:(NSNotification *)notification

Параметры

notification

Отправленное уведомление.

Обсуждение

Этот метод вызывается в результате регистрации NSOutlineViewItemDidCollapseNotification.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Редактирование элементов


    
    outlineView (_: shouldEditTableColumn:item:)
    - outlineView:shouldEditTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldEditTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldEditTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы.
`item`	Элемент.

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

YEStrue разрешать outlineView отредактировать ячейку, указанную tableColumn и item, NOfalse отклонять разрешение.

Если возвращается этот метод YEStrue, ячейка все еще может не быть доступной для редактирования — например, при установке пользовательского NSTextFieldCell как ячейка данных, это должно возвратиться YEStrue для isEditable позволить редактировать.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

См. также

outlineView:setObjectValue:forTableColumn:byItem: (Протокол NSOutlineViewDatasource)

Работа со столбцами таблицы


    
    outlineView (_: mouseDownInHeaderOfTableColumn:)
    - outlineView:mouseDownInHeaderOfTableColumn:

Отправленный делегату каждый раз, когда в кнопке мыши щелкают outlineView в то время как курсор находится в заголовке столбца tableColumn.

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, mouseDownInHeaderOfTableColumn tableColumn: NSTableColumn)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView mouseDownInHeaderOfTableColumn:(NSTableColumn *)tableColumn

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: didClickTableColumn:)
    - outlineView:didClickTableColumn:

Отправленный в то время, когда кнопка мыши впоследствии восстанавливает работоспособность в outlineView и tableColumn «щелкнулся», не будучи перетащенным никуда.

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, didClickTableColumn tableColumn: NSTableColumn)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView didClickTableColumn:(NSTableColumn *)tableColumn

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: didDragTableColumn:)
    - outlineView:didDragTableColumn:

Отправленный в то время, когда кнопка мыши восстанавливает работоспособность в outlineView и tableColumn был перетащен в течение времени, на которое снизилась кнопка мыши.

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, didDragTableColumn tableColumn: NSTableColumn)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView didDragTableColumn:(NSTableColumn *)tableColumn

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Настройка столбца и размеров строки


    
    outlineView (_: heightOfRowByItem:)
    - outlineView:heightOfRowByItem:

Возвращает высоту в точках строки, содержащей item.

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, heightOfRowByItem item: AnyObject) -> CGFloat

Objective C

- (CGFloat)outlineView:(NSOutlineView *)outlineView heightOfRowByItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент строки.

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

Высота строки.

Обсуждение

Значения, возвращенные этим методом, не должны включать интервал межъячейки и должны быть больше, чем 0.

Реализуйте этот метод для поддержки представления схемы с переменными высотами строки.

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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


    
    outlineView (_: sizeToFitWidthOfColumn:)
    - outlineView:sizeToFitWidthOfColumn:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, sizeToFitWidthOfColumn column: Int) -> CGFloat

Objective C

- (CGFloat)outlineView:(NSOutlineView *)outlineView sizeToFitWidthOfColumn:(NSInteger)column

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`column`	Индекс столбца.

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

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

Обсуждение

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

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

Настройка поддержки отслеживания


    
    outlineView (_: shouldTrackCell:forTableColumn:item:)
    - outlineView:shouldTrackCell:forTableColumn:item:

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, shouldTrackCell cell: NSCell, forTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView shouldTrackCell:(NSCell *)cell forTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`cell`	Ячейка, привыкшая к экспонату `item` в столбце `tableColumn`
`tableColumn`	Столбец таблицы в представлении схемы.
`item`	Элемент в представлении схемы.

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

YEStrue если ячейка должна быть прослежена для элемента item в столбце tableColumn, иначе NOfalse.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

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


    
    outlineView (_: isGroupItem:)
    - outlineView:isGroupItem:

Возвращает булевскую переменную, указывающую, должна ли данная строка быть нарисована в “стиле” строки группы.

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, isGroupItem item: AnyObject) -> Bool

Objective C

- (BOOL)outlineView:(NSOutlineView *)outlineView isGroupItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент в представлении схемы.

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

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

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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

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

Работа с находящимися в NSView представлениями схемы


    
    outlineView (_: didAddRowView:forRow:)
    - outlineView:didAddRowView:forRow:

Требуемый

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

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, didAddRowView rowView: NSTableRowView, forRow row: Int)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView didAddRowView:(NSTableRowView *)rowView forRow:(NSInteger)row

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`rowView`	Новое представление строки.
`row`	Строка, к которой было добавлено представление.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    outlineView (_: didRemoveRowView:forRow:)
    - outlineView:didRemoveRowView:forRow:

Требуемый

Реализованный для знания, когда представление строки удалено из (требуемой) таблицы

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, didRemoveRowView rowView: NSTableRowView, forRow row: Int)

Objective C

- (void)outlineView:(NSOutlineView *)outlineView didRemoveRowView:(NSTableRowView *)rowView forRow:(NSInteger)row

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`rowView`	Удаленное представление строки.
`row`	Число строки, удаленной вследствие того, чтобы быть перемещенным вне экрана, или `-1` если строка была удалена из таблицы, таким образом, это больше не действительно.

Обсуждение

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    outlineView (_: rowViewForItem:)
    - outlineView:rowViewForItem:

Требуемый

реализуйте этот метод для возврата пользовательского NSTableRowView для определенного элемента. (требуемый)

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, rowViewForItem item: AnyObject) -> NSTableRowView?

Objective C

- (NSTableRowView *)outlineView:(NSOutlineView *)outlineView rowViewForItem:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`item`	Элемент выведен на экран возвращенным представлением строки таблицы.

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

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

Обсуждение

Этот метод, если реализовано, только вызывается для находящихся в NSView представлений схемы.

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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


    
    outlineView (_: viewForTableColumn:item:)
    - outlineView:viewForTableColumn:item:

Требуемый

Реализованный для возврата представления раньше выводил на экран указанный элемент и столбец. (требуемый)

Объявление

Swift

optional func outlineView(_ outlineView: NSOutlineView, viewForTableColumn tableColumn: NSTableColumn?, item item: AnyObject) -> NSView?

Objective C

- (NSView *)outlineView:(NSOutlineView *)outlineView viewForTableColumn:(NSTableColumn *)tableColumn item:(id)item

Параметры

`outlineView`	Представление схемы, отправившее сообщение.
`tableColumn`	Столбец таблицы, или `nil` если строка является строкой группы.
`item`	Элемент выведен на экран возвращенным представлением.

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

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

Обсуждение

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

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

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

Если по крайней мере один идентификатор был связан с табличным представлением во время проектирования, при использовании привязки Какао этот метод является дополнительным. Если этот метод не реализован, представление схемы автоматически вызывает makeViewWithIdentifier:owner: с tableColumn идентификатор параметра и делегат представления схемы, поскольку параметры, чтобы попытаться снова использовать предыдущее представление или автоматически разархивировать прототип связались с табличным представлением.

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

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

Objective C

@import AppKit;

Swift

import AppKit

Доступность

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