NSTreeController
NSTreeController
привязка совместимый контроллер, управляющий деревом объектов. Это обеспечивает управление видом и выбор. Его основная цель состоит в том, чтобы действовать как контроллер при привязке NSOutlineView
и NSBrowser
экземпляры к иерархическому набору объектов. Корневой объект содержания дерева может быть отдельным объектом или массивом объектов.
NSTreeController
объект требует, чтобы Вы описали, как дерево объектов пересечено путем указания ключевого пути для дочерних объектов, указанных childrenKeyPath
. Все дочерние объекты для дерева должны быть значением ключа, кодирующим совместимый для того же дочернего ключевого пути. Если необходимо, необходимо добавить свойства к классам модели, отображающим дочернее ключевое имя к надлежащему специфичному для класса имени свойства.
Дочерние объекты могут реализовать метод счета (указанный к древовидному использованию контроллера countKeyPath
) это, если предоставленный, возвращает число доступных дочерних объектов. Ваши объекты модели, как ожидают, обновят значение ключевого пути количества в значении ключа, наблюдая совместимый метод. Дополнительно, можно также обеспечить листовое ключевое использование пути leafKeyPath
это указывает ключ в Вашем возвращающемся объекте модели YES
true
если объект является вершиной, и NO
false
если это не. Изменения в значении вершины дочернего объекта должны быть внесены в значении ключа, наблюдая совместимый способ. Обеспечение ключевого пути вершины может улучшить производительность, потому что это предотвращает NSTreeController
от необходимости исследовать дочерний объект, чтобы определить, является ли это вершина.
Наследование
-
NSObject
-
NSController
-
NSObjectController
-
NSTreeController
-
NSObject
-
NSController
-
NSObjectController
-
NSTreeController
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSObjectProtocol
-
Печатаемый
-
NSCoding
-
NSObject
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.4 и позже.
-
sortDescriptors sortDescriptors
СвойствоМассив, содержащий дескрипторы вида раньше, располагал содержание древовидного контроллера.
Объявление
Swift
var sortDescriptors: [AnyObject]!
Objective C
@property(copy) NSArray *sortDescriptors
Обсуждение
Когда значение этого свойства
nil
, древовидный контроллер не имеет никаких сконфигурированных дескрипторов вида, что означает, что содержание располагается в их естественном порядке. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
содержание содержание
СвойствоОбъект содержания древовидного контроллера.
Объявление
Swift
var content: AnyObject!
Objective C
@property(strong) id content
Обсуждение
Значение этого свойства может быть массивом объектов или единственным корневым объектом. Значение по умолчанию
nil
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
arrangedObjects arrangedObjects
СвойствоСортированные объекты содержания древовидного контроллера. (только для чтения)
Объявление
Swift
var arrangedObjects: AnyObject { get }
Objective C
@property(readonly, strong) id arrangedObjects
Обсуждение
Значение этого свойства представляет корневой древовидный узел прокси, содержащий сортированные объекты содержания древовидного контроллера. Объект прокси отвечает на
childNodes
иdescendantNodeAtIndexPath:
сообщения. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Используйте этот метод для инициирования переупорядочения содержания древовидного контроллера.
Объявление
Swift
func rearrangeObjects()
Objective C
- (void)rearrangeObjects
Обсуждение
Подклассы должны вызвать этот метод, если любой параметр, влияющий на расположенные изменения объектов.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Устанавливает текущий выбор древовидного контроллера.
Объявление
Swift
func setSelectionIndexPath(_
indexPath
: NSIndexPath?) -> BoolObjective C
- (BOOL)setSelectionIndexPath:(NSIndexPath *)
indexPath
Параметры
indexPath
Предложенный новый выбор.
Возвращаемое значение
Возвратиться
YES
true
если выбор изменился, иначеNO
false
.Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
selectionIndexPath selectionIndexPath
СвойствоИндексный путь первого выбранного объекта. (только для чтения)
Объявление
Swift
@NSCopying var selectionIndexPath: NSIndexPath? { get }
Objective C
@property(readonly, copy) NSIndexPath *selectionIndexPath
Обсуждение
Значение этого свойства
nil
если нет никакого выбора. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Устанавливает текущий выбор древовидного контроллера в указанные индексные пути.
Объявление
Swift
func setSelectionIndexPaths(_
indexPaths
: [AnyObject]!) -> BoolObjective C
- (BOOL)setSelectionIndexPaths:(NSArray *)
indexPaths
Параметры
indexPaths
Массив
NSIndexPath
объекты, указывающие выбранные объекты.Возвращаемое значение
Возвратиться
YES
true
если выбор изменился, иначеNO
false
.Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
selectionIndexPaths selectionIndexPaths
СвойствоМассив, содержащий индексные пути в настоящее время выбранных объектов. (только для чтения)
Объявление
Swift
var selectionIndexPaths: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *selectionIndexPaths
Обсуждение
Это свойство содержит массив, содержащий
NSIndexPath
объекты для каждого из выбранных объектов в содержании древовидного контроллера. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
selectedObjects selectedObjects
СвойствоМассив, содержащий в настоящее время выбранные объекты в содержании древовидного контроллера. (только для чтения)
Объявление
Swift
var selectedObjects: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *selectedObjects
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
selectedNodes selectedNodes
СвойствоМассив, содержащий выбранные древовидные узлы древовидного контроллера. (только для чтения)
Объявление
Swift
var selectedNodes: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *selectedNodes
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Булево значение, указывающее, выбирает ли древовидный контроллер автоматически объекты, поскольку они вставляются.
Объявление
Swift
var selectsInsertedObjects: Bool
Objective C
@property BOOL selectsInsertedObjects
Обсуждение
Значение по умолчанию этого свойства
YES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Добавляют объекты в указанном
indexPaths
в содержании древовидного контроллера к текущему выбору.Объявление
Swift
func addSelectionIndexPaths(_
indexPaths
: [AnyObject]) -> BoolObjective C
- (BOOL)addSelectionIndexPaths:(NSArray *)
indexPaths
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Удаляет объекты в указанном
indexPaths
от текущего выбора древовидного контроллера, возвращаясьYES
true
если был изменен выбор.Объявление
Swift
func removeSelectionIndexPaths(_
indexPaths
: [AnyObject]) -> BoolObjective C
- (BOOL)removeSelectionIndexPaths:(NSArray *)
indexPaths
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
avoidsEmptySelection avoidsEmptySelection
СвойствоБулево значение, указывающее, требует ли древовидный контроллер, чтобы довольное массив попыталось поддержать выбор в любом случае, избежав пустого выбора.
Объявление
Swift
var avoidsEmptySelection: Bool
Objective C
@property BOOL avoidsEmptySelection
Обсуждение
Когда значение этого свойства
YES
true
, древовидный контроллер поддерживает выбор, при отсутствии объектов в содержании. Значение по умолчаниюYES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
preservesSelection preservesSelection
СвойствоБулево значение, указывающее, попытается ли древовидный контроллер сохранить текущий выбор, когда изменится содержание.
Объявление
Swift
var preservesSelection: Bool
Objective C
@property BOOL preservesSelection
Обсуждение
Когда значение этого свойства
YES
true
, выбор сохраняется, если это возможно. Значение по умолчаниюYES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Булево значение, указывающее, возвращает ли древовидный контроллер всегда многократный маркер значений, когда многократные объекты выбраны, даже если выбранные пункты имеют то же значение.
Объявление
Swift
var alwaysUsesMultipleValuesMarker: Bool
Objective C
@property BOOL alwaysUsesMultipleValuesMarker
Обсуждение
Установка этого свойства к
YES
true
если Ваше приложение не позволяет редактировать многократные значения, может увеличить производительность. Значение по умолчаниюNO
false
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Добавляет объект к содержанию древовидного контроллера после текущего выбора.
Объявление
Swift
func add(_
sender
: AnyObject?)Objective C
- (void)add:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Если получатель находится в объектном режиме,
newObject
вызывается и возвращенный объект добавляется к набору. Если получатель находится в режиме объекта, новый объект создается, который надлежащий, как указано объектом, иnewObject
не используется. Объект добавляется после текущего выбора на той же глубине. Если нет никакого выбора, объект добавляется к дочерним узлам сортированных объектов содержания древовидного контроллера, представленных значениемarrangedObjects
.Специальные замечания
Результат этого метода задерживается до следующей итерации цикла выполнения так, чтобы ошибочный механизм представления мог обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Добавляет дочерний объект к в настоящее время выбранный пункт.
Объявление
Swift
func addChild(_
sender
: AnyObject?)Objective C
- (void)addChild:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Если получатель находится в объектном режиме
newObject
вызывается и возвращенный объект добавляется как дочерний элемент. Если получатель находится в режиме объекта, новый объект создается, который подходящий для отношения, как указано объектом, иnewObject
не используется.Специальные замечания
Результат этого метода задерживается до следующей итерации цикла выполнения так, чтобы ошибочный механизм представления мог обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
canAddChild canAddChild
СвойствоБулево значение, указывающее, может ли дочерний объект быть добавлен к содержанию древовидного контроллера. (только для чтения)
Объявление
Swift
var canAddChild: Bool { get }
Objective C
@property(readonly) BOOL canAddChild
Обсуждение
Значение этого свойства
YES
true
если дочерний объект может быть добавлен к содержанию древовидного контроллера. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Булево значение, указывающее, может ли объект быть вставлен в содержание древовидного контроллера. (только для чтения)
Объявление
Swift
var canInsert: Bool { get }
Objective C
@property(readonly) BOOL canInsert
Обсуждение
Значение этого свойства
YES
true
если объект может быть вставлен в содержание древовидного контроллера. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
canInsertChild canInsertChild
СвойствоБулево значение, указывающее, может ли дочерний объект быть вставлен в содержание древовидного контроллера. (только для чтения)
Объявление
Swift
var canInsertChild: Bool { get }
Objective C
@property(readonly) BOOL canInsertChild
Обсуждение
Значение этого свойства
YES
true
если дочерний объект может быть вставлен в содержание древовидного контроллера. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Создает новый объект класса, указанного
objectClass
и вставляет его в содержание древовидного контроллера.Объявление
Swift
func insert(_
sender
: AnyObject?)Objective C
- (void)insert:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Если получатель находится в объектном режиме
newObject
вызывается и возвращенный объект вставляется в набор. Если получатель находится в режиме объекта, новый объект создается, который надлежащий, как указано объектом, иnewObject
не используется.Специальные замечания
Результат этого метода задерживается до следующей итерации цикла выполнения так, чтобы ошибочный механизм представления мог обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Создает новый объект класса, указанного
objectClass
и вставляет его в содержание древовидного контроллера как дочерний элемент текущего выбора.Объявление
Swift
func insertChild(_
sender
: AnyObject?)Objective C
- (void)insertChild:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Если получатель находится в объектном режиме
newObject
вызывается и возвращенный объект вставляется как дочерний элемент. Если получатель находится в режиме объекта, новый объект создается, который подходящий для отношения, как указано объектом, иnewObject
не используется.Специальные замечания
Результат этого метода задерживается до следующей итерации цикла выполнения так, чтобы ошибочный механизм представления мог обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Вставляет
object
в расположенные объекты древовидного контроллера выстраивают в расположении, указанномindexPath
, и добавляет его к содержанию древовидного контроллера.Объявление
Swift
func insertObject(_
object
: AnyObject!, atArrangedObjectIndexPathindexPath
: NSIndexPath)Objective C
- (void)insertObject:(id)
object
atArrangedObjectIndexPath:(NSIndexPath *)indexPath
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Вставляет
objects
в расположенные объекты древовидного контроллера выстраивают в расположениях, указанных вindexPaths
, и добавляет их к содержанию древовидного контроллера.Объявление
Swift
func insertObjects(_
objects
: [AnyObject], atArrangedObjectIndexPathsindexPaths
: [AnyObject])Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Удаляет выбранные объекты древовидного контроллера из содержания.
Объявление
Swift
func remove(_
sender
: AnyObject?)Objective C
- (void)remove:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Специальные замечания
Результат этого метода задерживается до следующей итерации цикла выполнения так, чтобы ошибочный механизм представления мог обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Удаляет объект в указанном
indexPath
в расположенных объектах древовидного контроллера от содержания древовидного контроллера.Объявление
Swift
func removeObjectAtArrangedObjectIndexPath(_
indexPath
: NSIndexPath)Objective C
- (void)removeObjectAtArrangedObjectIndexPath:(NSIndexPath *)
indexPath
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Удаляет объекты в указанном
indexPaths
в расположенных объектах древовидного контроллера от содержания древовидного контроллера.Объявление
Swift
func removeObjectsAtArrangedObjectIndexPaths(_
indexPaths
: [AnyObject])Objective C
- (void)removeObjectsAtArrangedObjectIndexPaths:(NSArray *)
indexPaths
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
См. также
-
Перемещает указанный древовидный узел в новый индексный путь.
Объявление
Swift
func moveNode(_
node
: NSTreeNode, toIndexPathindexPath
: NSIndexPath)Objective C
- (void)moveNode:(NSTreeNode *)
node
toIndexPath:(NSIndexPath *)indexPath
Параметры
node
Древовидный узел.
indexPath
Индексный путь, указывающий новую позицию в содержании древовидного контроллера.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Перемещает указанные древовидные узлы в новый индексный путь.
Объявление
Swift
func moveNodes(_
nodes
: [AnyObject], toIndexPathstartingIndexPath
: NSIndexPath)Objective C
- (void)moveNodes:(NSArray *)
nodes
toIndexPath:(NSIndexPath *)startingIndexPath
Параметры
nodes
Массив древовидных узлов.
startingIndexPath
Индексный путь, указывающий стартовую позицию для перемещения древовидные узлы в в содержании древовидного контроллера.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
childrenKeyPath childrenKeyPath
СвойствоКлючевой путь раньше находил дочерние элементы в объектах древовидного контроллера.
Обсуждение
Значение по умолчанию этого свойства
nil
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Возвращается ключевой путь раньше находил дочерние элементы в указанном древовидном узле.
Объявление
Swift
func childrenKeyPathForNode(_
node
: NSTreeNode) -> String?Objective C
- (NSString *)childrenKeyPathForNode:(NSTreeNode *)
node
Параметры
node
Древовидный узел в содержании древовидного контроллера.
Возвращаемое значение
Строка, содержащая ключевой путь в
node
это обеспечивает дочерние узлы.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
countKeyPath countKeyPath
СвойствоКлючевой путь раньше находил число дочерних элементов для узла.
Обсуждение
Указание этого ключевого пути (если данные доступны в объекте модели) может увеличить производительность, но отключает, вставляют и удаляют функциональность.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Возвращает ключевой путь, обеспечивающий число дочерних элементов для указанного узла.
Объявление
Swift
func countKeyPathForNode(_
node
: NSTreeNode) -> String?Objective C
- (NSString *)countKeyPathForNode:(NSTreeNode *)
node
Параметры
node
Древовидный узел в содержании древовидного контроллера.
Возвращаемое значение
Строка, содержащая ключевой путь в
node
это обеспечивает число дочерних элементов.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
leafKeyPath leafKeyPath
СвойствоКлючевой путь, используемый древовидным контроллером, чтобы определить, является ли узел листовым ключом.
Обсуждение
Указание ключевого пути для этого свойства является дополнительным. Если древовидный контроллер в состоянии решить, что узел является вершиной, это может отключить вставку или добавление дочерних элементов к тем узлам.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Возвращает ключевой путь, указывающий, является ли узел вершиной.
Объявление
Swift
func leafKeyPathForNode(_
node
: NSTreeNode) -> String?Objective C
- (NSString *)leafKeyPathForNode:(NSTreeNode *)
node
Параметры
node
Древовидный узел в содержании древовидного контроллера.
Возвращаемое значение
Строка, содержащая ключевой путь в
node
это указывает, что узел является вершиной.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.