NSArrayController
NSArrayController
привязка совместимый класс, управляющий набором объектов. Обычно набор является массивом, однако, если контроллер управляет отношением управляемого объекта (см. NSManagedObject
) набор может быть набором. NSArrayController
обеспечивает управление выбором и возможности сортировки.
Наследование
-
NSObject
-
NSController
-
NSObjectController
-
NSArrayController
-
NSDictionaryController
-
NSObject
-
NSController
-
NSObjectController
-
NSArrayController
-
NSDictionaryController
Соответствует
-
AnyObject
-
CVarArgType
-
Сопоставимый
-
Hashable
-
NSCoding
-
NSObjectProtocol
-
Печатаемый
-
NSCoding
-
NSObject
Оператор импорта
Swift
import AppKit
Objective C
@import AppKit;
Доступность
Доступный в OS X v10.3 и позже.
-
Массив
NSSortDescriptor
объекты, используемые получателем для расположения его содержанияОбъявление
Swift
var sortDescriptors: [AnyObject]!
Objective C
@property(copy) NSArray *sortDescriptors
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Возвращает данный массив, соответственно сортированный и отфильтрованный.
Объявление
Swift
func arrangeObjects(_
objects
: [AnyObject]) -> [AnyObject]Возвращаемое значение
Массив, содержащий
objects
отфильтрованное использование предиката фильтра получателя (см. filterPredicate), и сортированный согласно получателюsortDescriptors
.Обсуждение
Подклассы должны переопределить этот метод, чтобы использовать различный механизм вида, обеспечить расположение пользовательского объекта, или (обычно только до версии 10.4 OS X, обеспечивающей, предикат фильтра) фильтруют объекты.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
arrangedObjects arrangedObjects
СвойствоМассив, содержащий объекты содержания получателя, расположил использование
arrangeObjects:
. (только для чтения)Объявление
Swift
var arrangedObjects: AnyObject { get }
Objective C
@property(readonly, strong) id arrangedObjects
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Триггерная фильтрация содержания получателя.
Объявление
Swift
func rearrangeObjects()
Objective C
- (void)rearrangeObjects
Обсуждение
Этот метод вызывает
arrangeObjects:
.Когда Вы обнаруживаете что, фильтруя изменение критериев (такой, слушая текст, отправленный
NSSearchField
экземпляр), вызовите этот метод наself
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Создает и добавляет новый объект к содержанию получателя и расположенные объекты.
Объявление
Swift
func add(_
sender
: AnyObject?)Objective C
- (void)add:(id)
sender
Параметры
sender
Обычно объект, вызвавший этот метод.
Специальные замечания
Начало с OS X v10.4 результат этого метода задерживается до следующей итерации runloop так, чтобы ошибочный механизм представления (см. Ошибочных Респондентов и Восстановление после ошибки), может обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
avoidsEmptySelection avoidsEmptySelection
СвойствоБулево значение, указывающее, требует ли получатель что довольное попытка массива поддержать выбор
Объявление
Swift
var avoidsEmptySelection: Bool
Objective C
@property BOOL avoidsEmptySelection
Обсуждение
Значение по умолчанию
YES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
preservesSelection preservesSelection
СвойствоБулево значение, указывающее, попытается ли получатель сохранить текущий выбор, когда изменится содержание
Объявление
Swift
var preservesSelection: Bool
Objective C
@property BOOL preservesSelection
Обсуждение
Значение по умолчанию
YES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Булево значение, указывающее, возвращает ли получатель всегда многократный маркер значений, когда выбраны многократные объекты
Объявление
Swift
var alwaysUsesMultipleValuesMarker: Bool
Objective C
@property BOOL alwaysUsesMultipleValuesMarker
Обсуждение
Значение по умолчанию
NO
false
. Установка вYES
true
если Ваше приложение не позволяет редактировать многократные значения, может увеличить производительность. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
selectionIndex selectionIndex
СвойствоИндекс первого объекта в выборе получателя (только для чтения)
Объявление
Swift
var selectionIndex: Int { get }
Objective C
@property(readonly) NSUInteger selectionIndex
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Устанавливает выбор получателя в данный индекс и возвращает булево значение, указывающее, был ли изменен выбор.
Объявление
Swift
func setSelectionIndex(_
index
: Int) -> BoolObjective C
- (BOOL)setSelectionIndex:(NSUInteger)
index
Параметры
index
Индекс для выбора.
Возвращаемое значение
YES
true
если выбор был изменен, иначеNO
false
.Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Наборы, выберет ли получатель автоматически объекты, поскольку они вставляются.
Объявление
Swift
var selectsInsertedObjects: Bool
Objective C
@property BOOL selectsInsertedObjects
Параметры
flag
Если
YES
true
тогда элементы будут выбраны на вставку.Обсуждение
Значение по умолчанию
YES
true
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Булево значение, указывающее, выбирает ли получатель автоматически вставленные объекты
Объявление
Swift
var selectsInsertedObjects: Bool
Objective C
@property BOOL selectsInsertedObjects
Обсуждение
Значение по умолчанию
YES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Устанавливает индексы выбора получателя и возвращает булево значение, указывающее, изменился ли выбор.
Объявление
Swift
func setSelectionIndexes(_
indexes
: NSIndexSet!) -> BoolObjective C
- (BOOL)setSelectionIndexes:(NSIndexSet *)
indexes
Параметры
indexes
Набор выбора индексирует для получателя.
Возвращаемое значение
YES
true
если выбор был изменен, иначеNO
false
.Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Для выбора объектов всего получателя индексы должны быть индексным набором с индексами
[0...count -1]
. Для отмены выбора всех индексов передайте пустой индексный набор.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
selectionIndexes selectionIndexes
СвойствоИндексный набор, содержащий индексы в настоящее время выбранных объектов получателя в довольном массив (только для чтения)
Объявление
Swift
@NSCopying var selectionIndexes: NSIndexSet { get }
Objective C
@property(readonly, copy) NSIndexSet *selectionIndexes
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Добавляют объекты в указанных индексах в массиве содержания получателя к текущему выбору, возвращаясь
YES
true
если был изменен выбор.Объявление
Swift
func addSelectionIndexes(_
indexes
: NSIndexSet) -> BoolObjective C
- (BOOL)addSelectionIndexes:(NSIndexSet *)
indexes
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Удаляет объект как указанное
indexes
от текущего выбора получателя, возвращаясьYES
true
если был изменен выбор.Объявление
Swift
func removeSelectionIndexes(_
indexes
: NSIndexSet) -> BoolObjective C
- (BOOL)removeSelectionIndexes:(NSIndexSet *)
indexes
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Наборы
objects
как текущий выбор получателя, возвращаясьYES
true
если был изменен выбор.Объявление
Swift
func setSelectedObjects(_
objects
: [AnyObject]) -> BoolObjective C
- (BOOL)setSelectedObjects:(NSArray *)
objects
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
selectedObjects selectedObjects
СвойствоМассив, содержащий выбранные объекты получателя (только для чтения)
Объявление
Swift
var selectedObjects: [AnyObject]! { get }
Objective C
@property(readonly, copy) NSArray *selectedObjects
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Добавляет
objects
от содержания получателя выстраивают к текущему выбору, возвращаясьYES
true
если был изменен выбор.Объявление
Swift
func addSelectedObjects(_
objects
: [AnyObject]) -> BoolObjective C
- (BOOL)addSelectedObjects:(NSArray *)
objects
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Удаляет
objects
от текущего выбора получателя, возвращаясьYES
true
если был изменен выбор.Объявление
Swift
func removeSelectedObjects(_
objects
: [AnyObject]) -> BoolObjective C
- (BOOL)removeSelectedObjects:(NSArray *)
objects
Обсуждение
Попытка изменить выбор может вызвать a
commitEditing
сообщение, переставшее работать, таким образом отклоняя изменение выбора.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Выбирает следующий объект, относительно текущего выбора, в расположенном содержании получателя.
Объявление
Swift
func selectNext(_
sender
: AnyObject?)Objective C
- (void)selectNext:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Специальные замечания
Начало с OS X v10.4 результат этого метода задерживается до следующей итерации runloop так, чтобы ошибочный механизм представления (см. Ошибочных Респондентов и Восстановление после ошибки), может обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
canSelectNext canSelectNext
СвойствоБулево значение, указывающее, может ли следующий объект, относительно текущего выбора, в массиве содержания получателя быть выбран (только для чтения)
Объявление
Swift
var canSelectNext: Bool { get }
Objective C
@property(readonly) BOOL canSelectNext
Обсуждение
Это свойство может использоваться привязкой для включения элементов интерфейса пользователя. Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Выбирает предыдущий объект, относительно текущего выбора, в расположенном содержании получателя.
Объявление
Swift
func selectPrevious(_
sender
: AnyObject?)Objective C
- (void)selectPrevious:(id)
sender
Обсуждение
sender
обычно объект, вызвавший этот метод.Специальные замечания
Начало с OS X v10.4 результат этого метода задерживается до следующей итерации runloop так, чтобы ошибочный механизм представления (см. Ошибочных Респондентов и Восстановление после ошибки), может обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
canSelectPrevious canSelectPrevious
СвойствоБулево значение, указывающее, может ли предыдущий объект, относительно текущего выбора, в массиве содержания получателя быть выбран (только для чтения)
Объявление
Swift
var canSelectPrevious: Bool { get }
Objective C
@property(readonly) BOOL canSelectPrevious
Обсуждение
Это свойство может использоваться привязкой для включения элементов интерфейса пользователя. Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Возвращает булево значение, указывающее, может ли объект быть вставлен в набор содержания получателя. (только для чтения)
Объявление
Swift
var canInsert: Bool { get }
Objective C
@property(readonly) BOOL canInsert
Возвращаемое значение
YES
true
если объект может быть вставлен в набор содержания получателя, иначеNO
false
.Обсуждение
Результат этого метода может использоваться привязкой для включения элементов интерфейса пользователя.
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Создает новый объект и вставляет его в массив содержания получателя.
Объявление
Swift
func insert(_
sender
: AnyObject?)Objective C
- (void)insert:(id)
sender
Параметры
sender
Обычно объект, вызвавший этот метод.
Обсуждение
Если имя объекта указано (см.
entityName
), этот метод создает экземпляр класса, указанного объектом, иначе этот метод создает экземпляр класса, указанногоobjectClass
.Специальные замечания
Начало с OS X v10.4 результат этого метода задерживается до следующей итерации runloop так, чтобы ошибочный механизм представления (см. Ошибочных Респондентов и Восстановление после ошибки), может обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
См. также
-
Добавляет
object
к набору содержания получателя и расположенному массиву объектов.Объявление
Swift
func addObject(_
object
: AnyObject)Objective C
- (void)addObject:(id)
object
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Добавляет
objects
к набору содержания получателя.Объявление
Swift
func addObjects(_
objects
: [AnyObject])Objective C
- (void)addObjects:(NSArray *)
objects
Обсуждение
Если
selectsInsertedObjects
YES
true
(значение по умолчанию), добавленные объекты выбраны в контроллере массива.Важно отметить что, вставляя много объектов с
selectsInsertedObjects
на может вызвать значительную потерю производительности. В этом случае более эффективно использоватьsetContent:
метод, чтобы установить массив или установитьselectsInsertedObjects
кNO
false
прежде, чем добавить объекты сaddObjects:
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Вставляет
object
в расположенные объекты получателя выстраивают в расположении, указанномindex
, и добавляет его к набору содержания получателя.Объявление
Swift
func insertObject(_
object
: AnyObject, atArrangedObjectIndexindex
: Int)Objective C
- (void)insertObject:(id)
object
atArrangedObjectIndex:(NSUInteger)index
Обсуждение
Подклассы могут переопределить этот метод для оказания настроенной расположенной поддержки объектов. Если данный индекс за пределами, ошибка возвращается
arrangedObjects
диапазон, или если данный объект не появился бы в arrangedObjects. УстановитеclearsFilterPredicateOnInsertion
кYES
true
позволить вставку.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Вставляет
object
s в расположенные объекты получателя выстраивают в расположениях, указанных вindexes
, и добавляет его к набору содержания получателя.Объявление
Swift
func insertObjects(_
objects
: [AnyObject], atArrangedObjectIndexesindexes
: NSIndexSet)Objective C
- (void)insertObjects:(NSArray *)
objects
atArrangedObjectIndexes:(NSIndexSet *)indexes
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Удаляет объект в указанном
index
в расположенных объектах получателя от массива содержания получателя.Объявление
Swift
func removeObjectAtArrangedObjectIndex(_
index
: Int)Objective C
- (void)removeObjectAtArrangedObjectIndex:(NSUInteger)
index
Обсуждение
См. removeObject: для обсуждения семантики удаления объектов при использовании Базовых Данных.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Удаляет объекты в указанном
indexes
в расположенных объектах получателя от довольного массив.Объявление
Swift
func removeObjectsAtArrangedObjectIndexes(_
indexes
: NSIndexSet)Objective C
- (void)removeObjectsAtArrangedObjectIndexes:(NSIndexSet *)
indexes
Обсуждение
См. removeObject: для обсуждения семантики удаления объектов при использовании Базовых Данных.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Удаляет выбранные объекты получателя из набора содержания.
Объявление
Swift
func remove(_
sender
: AnyObject?)Objective C
- (void)remove:(id)
sender
Параметры
sender
Обычно объект, вызвавший этот метод.
Обсуждение
См. removeObject: для обсуждения семантики удаления объектов при использовании Базовых Данных.
Специальные замечания
Начало с OS X v10.4 результат этого метода задерживается до следующей итерации runloop так, чтобы ошибочный механизм представления (см. Ошибочных Респондентов и Восстановление после ошибки), может обеспечить обратную связь как лист.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Удаляет
object
от набора содержания получателя.Объявление
Swift
func removeObject(_
object
: AnyObject)Objective C
- (void)removeObject:(id)
object
Специальные замечания
Если Вы используете Базовые Данные, точная семантика этого метода отличаются в зависимости от настроек для контроллера массива. Если содержание получателя выбирается автоматически, удалил объекты, отмечены для удаления контекстом управляемого объекта (и следовательно удаление из графа объектов). Если, однако, получатель
contentSet
связывается с отношением,removeObject:
по умолчанию только удаляет объект из отношения (не от графа объектов). Можно, тем не менее, установить опцию «Deletes Object on Remove» дляcontentSet
привязка, когда объекты отмечены для удаления, а также удаляемый из отношения.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Удаляет
objects
от набора содержания получателя.Объявление
Swift
func removeObjects(_
objects
: [AnyObject])Objective C
- (void)removeObjects:(NSArray *)
objects
Специальные замечания
См. removeObject: для обсуждения семантики удаления объектов при использовании Базовых Данных.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.3 и позже.
-
Булево значение, указывающее, очищает ли получатель автоматически существующий предикат фильтра, когда новые элементы вставляются или добавляются к содержанию
Объявление
Swift
var clearsFilterPredicateOnInsertion: Bool
Objective C
@property BOOL clearsFilterPredicateOnInsertion
Обсуждение
Значение по умолчанию
YES
true
. Это свойство является заметным наблюдением значения ключа использования.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
filterPredicate filterPredicate
СвойствоПредикат, используемый получателем для фильтрации содержания контроллера массива
Объявление
Swift
var filterPredicate: NSPredicate?
Objective C
@property(strong) NSPredicate *filterPredicate
Обсуждение
Это свойство является заметным наблюдением значения ключа использования.
Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.4 и позже.
-
Булевская переменная, указывающая, перестраивает ли получатель автоматически свое содержание для соответствия текущим дескрипторам вида и предикатам фильтра
Объявление
Swift
var automaticallyRearrangesObjects: Bool
Objective C
@property BOOL automaticallyRearrangesObjects
Обсуждение
Значение по умолчанию
NO
false
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Массив ключевых путей, инициировавших автоматический довольный сортировка или фильтрация (только для чтения)
Объявление
Swift
var automaticRearrangementKeyPaths: [AnyObject]? { get }
Objective C
@property(readonly, copy) NSArray *automaticRearrangementKeyPaths
Обсуждение
Например, если дополнительные критерии расположения используются в пользовательской реализации, подклассы могут переопределить это свойство для настройки поведения по умолчанию дескрипторов вида и предикатов фильтрации
arrangedObjects
.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
-
Вызванный, когда любые критерии расположения изменения объектов.
Объявление
Swift
func didChangeArrangementCriteria()
Objective C
- (void)didChangeArrangementCriteria
Обсуждение
Этот метод вызывается самим контроллером когда любые критерии расположения изменения объектов (дескрипторы вида или предикаты фильтра) для сброса ключевых путей для автоматической реконструкции.
Специальные замечания
Если Вы реализуете подкласс
NSArrayController
и переопределениеrearrangeObjects
если те критерии изменяются, для использования дополнительных критериев расположения необходимо вызвать этот метод.Оператор импорта
Objective C
@import AppKit;
Swift
import AppKit
Доступность
Доступный в OS X v10.5 и позже.
См. также