Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AppKit ссылка класса NSCollectionView

Опции
Развертывание Target:

На этой странице
Язык:

NSCollectionView

NSCollectionView отображения объекта сетка представлений. Каждое представление в сетке представлено a NSCollectionViewItem объект, управляющий загрузкой содержания представления от Вашей раскадровки или файла пера. После добавления представления набора в Вашем окне используйте методы и свойства этого класса для управления содержанием представления набора и его поведения.

Наследование

Соответствует

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Изменение элемента представления набора
  • itemPrototype itemPrototype Свойство

    Набор получателя просматривает прототип элемента.

    Объявление

    Swift

    var itemPrototype: NSCollectionViewItem!

    Objective C

    @property(strong) NSCollectionViewItem *itemPrototype

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • newItemForRepresentedObject (_:) - newItemForRepresentedObject:

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

    Объявление

    Swift

    func newItemForRepresentedObject(_ object: AnyObject!) -> NSCollectionViewItem!

    Objective C

    - (NSCollectionViewItem *)newItemForRepresentedObject:(id)object

    Параметры

    object

    Объект содержания, который будет представлять элемент представления набора.

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

    Инициализированный набор просматривает элемент с указанным объектом и надлежащим установленным представлением. Элемент представления набора не должен быть автовыпущен.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Работа с цепочкой респондента
  • firstResponder firstResponder Свойство

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

    Объявление

    Swift

    var firstResponder: Bool { get }

    Objective C

    @property(getter=isFirstResponder, readonly) BOOL firstResponder

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Установка содержания
  • содержание содержание Свойство

    Массив, содержащий содержание получателя.

    Объявление

    Swift

    var content: [AnyObject]!

    Objective C

    @property(copy) NSArray *content

    Обсуждение

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

    Это свойство является заметным наблюдением значения ключа использования.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Установка режима выбора
  • можно выбрать можно выбрать Свойство

    Булево значение, указывающее, позволяет ли получатель пользователю выбирать элементы.

    Объявление

    Swift

    var selectable: Bool

    Objective C

    @property(getter=isSelectable) BOOL selectable

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • allowsMultipleSelection allowsMultipleSelection Свойство

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

    Объявление

    Swift

    var allowsMultipleSelection: Bool

    Objective C

    @property BOOL allowsMultipleSelection

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • selectionIndexes selectionIndexes Свойство

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

    Объявление

    Swift

    @NSCopying var selectionIndexes: NSIndexSet!

    Objective C

    @property(copy) NSIndexSet *selectionIndexes

    Обсуждение

    Для выбора всех элементов создайте NSRange введите, чье значение расположения 0 и чья длина является числом элементов в массиве минус 1 — другими словами, count - 1— и присвойте его этому свойству. Для отмены выбора всех элементов присвойте пустой индексный набор этому свойству.

    Это свойство является заметным наблюдением значения ключа использования.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Разметка Представления Набора
  • maxNumberOfRows maxNumberOfRows Свойство

    Максимальное количество строк, которые выводит на экран представление набора.

    Объявление

    Swift

    var maxNumberOfRows: Int

    Objective C

    @property NSUInteger maxNumberOfRows

    Обсуждение

    Когда значение этого свойства 0, представление набора не имеет никакого максимального количества строк. Значение по умолчанию этого свойства 0.

    Для представления набора возможно указать и максимальное количество строк и максимальное количество столбцов. Если число объектов содержания превышает число визуализуемых элементов (n =maxNumberOfRows * maxNumberOfColumns) только первые n элементы довольного массив выведены на экран.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • maxNumberOfColumns maxNumberOfColumns Свойство

    Максимальное количество столбцов, которые выводит на экран представление набора.

    Объявление

    Swift

    var maxNumberOfColumns: Int

    Objective C

    @property NSUInteger maxNumberOfColumns

    Обсуждение

    Когда значение этого свойства 0, представление набора не имеет никакого максимального количества столбцов. Значение по умолчанию этого свойства 0.

    Для представления набора возможно указать и максимальное количество строк и максимальное количество столбцов. Если число объектов содержания превышает число визуализуемых элементов (n =maxNumberOfRows * maxNumberOfColumns) только первые n элементы довольного массив выведены на экран.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • minItemSize minItemSize Свойство

    Минимальный размер (в точках) элементов в наборе просматривает сетку.

    Объявление

    Swift

    var minItemSize: NSSize

    Objective C

    @property NSSize minItemSize

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • maxItemSize maxItemSize Свойство

    Максимальный размер (в точках) элементов в наборе просматривает сетку.

    Объявление

    Swift

    var maxItemSize: NSSize

    Objective C

    @property NSSize maxItemSize

    Обсуждение

    Установка размера к (0, 0) средние значения, что нет никакого максимального размера сетки. Значение по умолчанию этого свойства (0, 0). Если представление элемента изменяемого размера, установите значение в максимальный размер, который должно использовать представление.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Изменение фона
  • backgroundColors backgroundColors Свойство

    Массив, содержащий цвета фона представления набора.

    Объявление

    Swift

    var backgroundColors: [AnyObject]!

    Objective C

    @property(copy) NSArray *backgroundColors

    Обсуждение

    Это свойство содержит массив NSColor объекты, представляя цвета для использования при рисовании фоновой сетки. Указание пустого массива или nil заставляет представление набора использовать цвета по умолчанию, возвращенные controlAlternatingRowBackgroundColors метод.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение и установка делегата
  • делегат делегат Свойство

    Делегат представления набора объект.

    Объявление

    Swift

    unowned(unsafe) var delegate: NSCollectionViewDelegate?

    Objective C

    @property(assign) id< NSCollectionViewDelegate > delegate

    Обсуждение

    Объект, который Вы присваиваете этому свойству, должен соответствовать NSCollectionViewDelegate Protocol протокол. Значение по умолчанию этого свойства nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Поддержка перетаскивания
  • draggingImageForItemsAtIndexes (_: withEvent:offset:) - draggingImageForItemsAtIndexes:withEvent:offset:

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

    Объявление

    Swift

    func draggingImageForItemsAtIndexes(_ indexes: NSIndexSet!, withEvent event: NSEvent!, offset dragImageOffset: NSPointPointer) -> NSImage!

    Objective C

    - (NSImage *)draggingImageForItemsAtIndexes:(NSIndexSet *)indexes withEvent:(NSEvent *)event offset:(NSPointPointer)dragImageOffset

    Параметры

    indexes

    Индексный набор элементов, которые будут перетащены.

    event

    Мышь перетаскивает событие.

    dragImageOffset

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

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

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

    Обсуждение

    Можно переопределить изображение по умолчанию путем разделения на подклассы NSCollectionView и переопределения этого метода, или путем реализации collectionView:draggingImageForItemsAtIndexes:withEvent:offset: метод делегата, это будет предпочтено по этому методу.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • setDraggingSourceOperationMask (_: forLocal:) - setDraggingSourceOperationMask:forLocal:

    Конфигурирует значение по умолчанию, возвращенное из draggingSourceOperationMaskForLocal:.

    Объявление

    Swift

    func setDraggingSourceOperationMask(_ dragOperationMask: NSDragOperation, forLocal localDestination: Bool)

    Objective C

    - (void)setDraggingSourceOperationMask:(NSDragOperation)dragOperationMask forLocal:(BOOL)localDestination

    Параметры

    dragOperationMask

    Типы операций перетаскивания позволяются.

    localDestination

    Если YEStrue, когда целевой объект перетаскивания находится в том же приложении как получатель, маска применяется; если NOfalse, когда целевой объект вне приложения получателя, маска применяется.

    Обсуждение

    По умолчанию, этот метод возвраты NSDragOperationEvery когда localDestination YEStrue и NSDragOperationNone когда localDestination NOfalse. NSCollectionView сохранит значения, которые Вы устанавливаете для каждого localDestination значение.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Получение Элемента Набора и его Кадра
  • itemAtIndex (_:) - itemAtIndex:

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

    Объявление

    Swift

    func itemAtIndex(_ index: Int) -> NSCollectionViewItem!

    Objective C

    - (NSCollectionViewItem *)itemAtIndex:(NSUInteger)index

    Параметры

    index

    Индекс набора просматривает элемент.

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

    Экземпляр NSCollectionViewItem.

    Обсуждение

    Вместо того, чтобы использовать NSCollectionViewItem экземпляр, возвращенный этим методом для определения кадра представления элемента набора, необходимо использовать frameForItemAtIndex:, это значительно более эффективно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • frameForItemAtIndex (_:) - frameForItemAtIndex:

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

    Объявление

    Swift

    func frameForItemAtIndex(_ index: Int) -> NSRect

    Objective C

    - (NSRect)frameForItemAtIndex:(NSUInteger)index

    Параметры

    index

    Индекс набора просматривает элемент.

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

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

    Обсуждение

    Можно использовать этот метод в collectionView:draggingImageForItemsAtIndexes:withEvent:offset: метод для определения, какие представления находятся в видимой части представления прокрутки включения.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • frameForItemAtIndex (_: withNumberOfItems:) - frameForItemAtIndex:withNumberOfItems:

    Возвращает кадр элемента на основе числа элементов в представлении набора.

    Объявление

    Swift

    func frameForItemAtIndex(_ index: Int, withNumberOfItems numberOfItems: Int) -> NSRect

    Objective C

    - (NSRect)frameForItemAtIndex:(NSUInteger)index withNumberOfItems:(NSUInteger)numberOfItems

    Параметры

    index

    Индекс элемента в представлении набора.

    numberOfItems

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • NSCollectionViewDropOperation

    Эти константы указывают, должно ли принятие отбрасывания быть в элементе, это отбрасывается на или перед элементом. Эти константы используются collectionView:acceptDrop:index:dropOperation: и collectionView:validateDrop:proposedIndex:dropOperation: методы в NSCollectionViewDelegate Protocol

    Объявление

    Swift

    enum NSCollectionViewDropOperation : Int { case On case Before }

    Objective C

    enum { NSCollectionViewDropOn = 0, NSCollectionViewDropBefore = 1, }; typedef NSInteger NSCollectionViewDropOperation;

    Константы

    • On

      NSCollectionViewDropOn

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

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

    • Before

      NSCollectionViewDropBefore

      Отбрасывание происходит выше элемента представления набора, к которому был перетащен элемент..

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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