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

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

Разработчик

Ссылка платформы UIKit ссылка класса UICollectionView

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

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

UICollectionView

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

Доступный в iOS 6.0 и позже.

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

При добавлении представления набора к пользовательскому интерфейсу основное задание приложения должно управлять данными, связанными с тем представлением набора. Представление набора получает свои данные от объекта источника данных, который является объектом, соответствующим UICollectionViewDataSource протокол и предоставлен Вашим приложением. Данные в представлении набора организованы в отдельные элементы, которые могут тогда быть сгруппированы в разделы для представления. Элемент является самой маленькой единицей информации, которую Вы хотите представить. Например, в фото приложении, элемент мог бы быть единственным изображением. Представление набора представляет элементы на экране с помощью ячейки, которая является экземпляром UICollectionViewCell класс, который Ваш источник данных конфигурирует и обеспечивает.

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

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

Представления набора и объекты расположения

Очень важный объект, связанный с представлением набора, является объектом расположения, который является подклассом UICollectionViewLayout класс. Объект расположения ответственен за определение организации и расположения всех ячеек и дополнительных представлений в представлении набора. Несмотря на то, что это определяет их расположения, объект расположения фактически не применяет ту информацию к соответствующим представлениям. Поскольку создание ячеек и дополнительные представления включают координацию между представлением набора и Вашим объектом источника данных, представление набора фактически применяет информацию макета к представлениям. Таким образом, в некотором смысле, объект расположения походит на другой источник данных, только предоставляя визуальную информацию вместо данных элемента.

Вы обычно указываете объект расположения при создании представления набора, но можно также изменить расположение представления набора динамично. Объект расположения хранится в collectionViewLayout свойство. Установка этого свойства непосредственно сразу обновляет расположение, не анимируя изменения. Если Вы хотите анимировать изменения, необходимо вызвать setCollectionViewLayout:animated:completion: метод вместо этого.

Если Вы хотите создать интерактивный переход — тот, управляющийся устройством распознавания жеста, или сенсорные события — используют startInteractiveTransitionToCollectionViewLayout:completion: метод для изменения объекта расположения. Тот метод устанавливает промежуточный объект расположения, цель которого состоит в том, чтобы работать с Вашим устройством распознавания жеста или кодом обработки событий для отслеживания прогресса перехода. Когда Ваш код обработки событий решает, что переход закончен, это вызывает finishInteractiveTransition или cancelInteractiveTransition метод для удаления промежуточного расположения возражает и устанавливает намеченный целевой объект расположения.

Создание ячеек и дополнительных представлений

Объект источника данных представления набора обеспечивает и содержание для элементов и представления, используемые для представления того содержания. Когда представление набора сначала загружает свое содержание, оно просит, чтобы его источник данных обеспечил представление для каждого видимого элемента. Для упрощения процесса создания для кода представление набора требует, чтобы Вы всегда исключали представления из очереди, вместо того, чтобы создать их явно в Вашем коде. Существует два метода для представлений исключения из очереди. Тот, который Вы используете, зависит, на котором требовали тип представления:

Перед вызовом любого из этих методов необходимо сказать представление набора, как создать соответствующее представление, если Вы уже не существуете. Для этого необходимо зарегистрировать или класс или файл пера с представлением набора. Например, при регистрации ячеек, Вы используете registerClass:forCellWithReuseIdentifier: или registerNib:forCellWithReuseIdentifier: метод. Как часть процесса регистрации, Вы указываете идентификатор повторного использования, идентифицирующий цель представления. Это - та же строка, которую Вы используете когда исключение из очереди представление позже.

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

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

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

Инициализация представления набора
  • init (frame:collectionViewLayout:) - initWithFrame:collectionViewLayout:

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

    Объявление

    Swift

    init(frame frame: CGRect, collectionViewLayout layout: UICollectionViewLayout)

    Objective C

    - (instancetype)initWithFrame:(CGRect)frame collectionViewLayout:(UICollectionViewLayout *)layout

    Параметры

    frame

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

    layout

    Объект расположения использовать для организации элементов. Представление набора хранит сильную ссылку к указанному объекту. Не должен быть nil.

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

    Инициализированный набор просматривает объект или nil если не мог бы быть создан объект.

    Обсуждение

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

    Этот метод является определяемым инициализатором.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Конфигурирование представления набора
  • delegate Свойство

    Объект, действующий как делегат представления набора.

    Объявление

    Swift

    unowned(unsafe) var delegate: UICollectionViewDelegate?

    Objective C

    @property(nonatomic, assign) id< UICollectionViewDelegate > delegate

    Обсуждение

    Делегат должен принять UICollectionViewDelegate протокол. Представление набора поддерживает слабую ссылку на объект делегата.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • dataSource Свойство

    Объект, предоставляющий данные для представления набора.

    Объявление

    Swift

    unowned(unsafe) var dataSource: UICollectionViewDataSource?

    Objective C

    @property(nonatomic, assign) id< UICollectionViewDataSource > dataSource

    Обсуждение

    Источник данных должен принять UICollectionViewDataSource протокол. Представление набора поддерживает слабую ссылку на объект источника данных.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • backgroundView Свойство

    Представление, обеспечивающее фоновое появление.

    Объявление

    Swift

    var backgroundView: UIView?

    Objective C

    @property(nonatomic, retain) UIView *backgroundView

    Обсуждение

    Представление (если таковые имеются) в этом свойстве расположено подо всем другим содержанием и измерено автоматически для заполнения всех границ представления набора. Фоновое представление не прокручивает с представлением набора другое содержание. Представление набора поддерживает сильную ссылку к фоновому объекту представления.

    Это свойство nil по умолчанию, который выводит на экран цвет фона представления набора.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Создание ячеек представления набора
  • registerClass (_: forCellWithReuseIdentifier:) - registerClass:forCellWithReuseIdentifier:

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

    Объявление

    Swift

    func registerClass(_ cellClass: AnyClass?, forCellWithReuseIdentifier identifier: String)

    Objective C

    - (void)registerClass:(Class)cellClass forCellWithReuseIdentifier:(NSString *)identifier

    Параметры

    cellClass

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

    identifier

    Идентификатор повторного использования для соединения с указанным классом. Этот параметр не должен быть nil и не должна быть пустая строка.

    Обсуждение

    До вызова dequeueReusableCellWithReuseIdentifier:forIndexPath: метод представления набора, необходимо использовать этот метод или registerNib:forCellWithReuseIdentifier: метод для сообщения набора просматривает, как создать новую ячейку данного типа. Если ячейка указанного типа в настоящее время не находится в очереди повторного использования, представление набора использует предоставленную информацию для создания нового объекта ячейки автоматически.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – registerNib:forCellWithReuseIdentifier:
    – dequeueReusableCellWithReuseIdentifier:forIndexPath:

  • registerNib (_: forCellWithReuseIdentifier:) - registerNib:forCellWithReuseIdentifier:

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

    Объявление

    Swift

    func registerNib(_ nib: UINib?, forCellWithReuseIdentifier identifier: String)

    Objective C

    - (void)registerNib:(UINib *)nib forCellWithReuseIdentifier:(NSString *)identifier

    Параметры

    nib

    Объект пера, содержащий объект ячейки. Файл пера должен содержать только один объект верхнего уровня и что объект должен иметь тип UICollectionViewCell.

    identifier

    Идентификатор повторного использования для соединения с указанным файлом пера. Этот параметр не должен быть nil и не должна быть пустая строка.

    Обсуждение

    До вызова dequeueReusableCellWithReuseIdentifier:forIndexPath: метод представления набора, необходимо использовать этот метод или registerClass:forCellWithReuseIdentifier: метод для сообщения набора просматривает, как создать новую ячейку данного типа. Если ячейка указанного типа в настоящее время не находится в очереди повторного использования, представление набора использует предоставленную информацию для создания нового объекта ячейки автоматически.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – registerClass:forCellWithReuseIdentifier:
    – dequeueReusableCellWithReuseIdentifier:forIndexPath:

  • registerClass (_: forSupplementaryViewOfKind:withReuseIdentifier:) - registerClass:forSupplementaryViewOfKind:withReuseIdentifier:

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

    Объявление

    Swift

    func registerClass(_ viewClass: AnyClass?, forSupplementaryViewOfKind elementKind: String, withReuseIdentifier identifier: String)

    Objective C

    - (void)registerClass:(Class)viewClass forSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier

    Параметры

    viewClass

    Класс для использования для дополнительного представления.

    elementKind

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

    identifier

    Идентификатор повторного использования для соединения с указанным классом. Этот параметр не должен быть nil и не должна быть пустая строка.

    Обсуждение

    До вызова dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath: метод представления набора, необходимо использовать этот метод или registerNib:forSupplementaryViewOfKind:withReuseIdentifier: метод для сообщения набора просматривает, как создать дополнительное представление данного типа. Если представление указанного типа в настоящее время не находится в очереди повторного использования, представление набора использует предоставленную информацию для создания объекта представления автоматически.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – registerNib:forSupplementaryViewOfKind:withReuseIdentifier:
    – dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath:

  • registerNib (_: forSupplementaryViewOfKind:withReuseIdentifier:) - registerNib:forSupplementaryViewOfKind:withReuseIdentifier:

    Регистрирует файл пера для использования в создании дополнительных представлений для представления набора.

    Объявление

    Swift

    func registerNib(_ nib: UINib?, forSupplementaryViewOfKind kind: String, withReuseIdentifier identifier: String)

    Objective C

    - (void)registerNib:(UINib *)nib forSupplementaryViewOfKind:(NSString *)kind withReuseIdentifier:(NSString *)identifier

    Параметры

    nib

    Объект пера, содержащий объект представления. Файл пера должен содержать только один объект верхнего уровня и что объект должен иметь тип UICollectionReusableView.

    kind

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

    identifier

    Идентификатор повторного использования для соединения с указанным файлом пера. Этот параметр не должен быть nil и не должна быть пустая строка.

    Обсуждение

    До вызова dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath: метод представления набора, необходимо использовать этот метод или registerClass:forSupplementaryViewOfKind:withReuseIdentifier: метод для сообщения набора просматривает, как создать дополнительное представление данного типа. Если представление указанного типа в настоящее время не находится в очереди повторного использования, представление набора использует предоставленную информацию для создания объекта представления автоматически.

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – registerClass:forSupplementaryViewOfKind:withReuseIdentifier:
    – dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath:

  • dequeueReusableCellWithReuseIdentifier (_: forIndexPath:) - dequeueReusableCellWithReuseIdentifier:forIndexPath:

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

    Объявление

    Swift

    func dequeueReusableCellWithReuseIdentifier(_ identifier: String, forIndexPath indexPath: NSIndexPath!) -> AnyObject

    Objective C

    - (id)dequeueReusableCellWithReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath

    Параметры

    identifier

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

    indexPath

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

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

    Допустимое UICollectionReusableView объект.

    Обсуждение

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

    Если Вы зарегистрировали класс для указанного identifier и новая ячейка должна быть создана, этот метод инициализирует ячейку путем вызова initWithFrame: метод. Для основанных на пере ячеек этот метод загружает объект ячейки из предоставленного файла пера. Если существующая ячейка была доступна для повторного использования, это вызовы метода ячейка prepareForReuse метод вместо этого.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – registerClass:forCellWithReuseIdentifier:
    – registerNib:forCellWithReuseIdentifier:

  • dequeueReusableSupplementaryViewOfKind (_: withReuseIdentifier:forIndexPath:) - dequeueReusableSupplementaryViewOfKind:withReuseIdentifier:forIndexPath:

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

    Объявление

    Swift

    func dequeueReusableSupplementaryViewOfKind(_ elementKind: String, withReuseIdentifier identifier: String, forIndexPath indexPath: NSIndexPath!) -> AnyObject

    Objective C

    - (id)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath

    Параметры

    elementKind

    Вид дополнительного представления для получения. Это значение определяется объектом расположения. Этот параметр не должен быть nil.

    identifier

    Идентификатор повторного использования для указанного представления. Этот параметр не должен быть nil.

    indexPath

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

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

    Допустимое UICollectionReusableView объект.

    Обсуждение

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

    Если Вы зарегистрировали класс для указанного identifier и новая ячейка должна быть создана, этот метод инициализирует ячейку путем вызова initWithFrame: метод. Для основанных на пере ячеек этот метод загружает объект ячейки из предоставленного файла пера. Если существующая ячейка была доступна для повторного использования, это вызовы метода ячейка prepareForReuse метод вместо этого.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Изменение расположения
  • collectionViewLayout Свойство

    Расположение раньше организовывало элементы собранного представления.

    Объявление

    Swift

    var collectionViewLayout: UICollectionViewLayout

    Objective C

    @property(nonatomic, retain) UICollectionViewLayout *collectionViewLayout

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • setCollectionViewLayout (_: анимированный:) - setCollectionViewLayout:animated:

    Изменяет расположение представления набора и дополнительно анимирует изменение.

    Объявление

    Swift

    func setCollectionViewLayout(_ layout: UICollectionViewLayout, animated animated: Bool)

    Objective C

    - (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated

    Параметры

    layout

    Новое расположение возражает для представления набора.

    animated

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – startInteractiveTransitionToCollectionViewLayout:completion:

  • setCollectionViewLayout (_: animated:completion:) - setCollectionViewLayout:animated:completion:

    Когда анимации завершаются, изменяет расположение представления набора и уведомляет Вас.

    Объявление

    Swift

    func setCollectionViewLayout(_ layout: UICollectionViewLayout, animated animated: Bool, completion completion: ((Bool) -> Void)!)

    Objective C

    - (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated completion:(void (^)(BOOL finished))completion

    Параметры

    layout

    Новое расположение возражает для представления набора.

    animated

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

    completion

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

    finished

    Булевская переменная, указывающая, завершился ли переход успешно. Этот параметр YEStrue если переход закончился, и новое расположение установлено. Это NOfalse если пользователь прервал переход и возвратился к старому расположению.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    – startInteractiveTransitionToCollectionViewLayout:completion:

  • startInteractiveTransitionToCollectionViewLayout (_: завершение:) - startInteractiveTransitionToCollectionViewLayout:completion:

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

    Объявление

    Swift

    func startInteractiveTransitionToCollectionViewLayout(_ layout: UICollectionViewLayout, completion completion: UICollectionViewLayoutInteractiveTransitionCompletion?) -> UICollectionViewTransitionLayout

    Objective C

    - (UICollectionViewTransitionLayout *)startInteractiveTransitionToCollectionViewLayout:(UICollectionViewLayout *)layout completion:(UICollectionViewLayoutInteractiveTransitionCompletion)completion

    Параметры

    layout

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

    completion

    Обработчик завершения для выполнения после перехода заканчивается.

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

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

    Обсуждение

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

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

    Этот метод возвращает экземпляр UICollectionViewTransitionLayout класс по умолчанию. Если Вы хотите, чтобы он возвратил пользовательский объект перехода вместо этого, реализуйте collectionView:transitionLayoutForOldLayout:newLayout: метод Вашего набора просматривает делегата и использует тот метод для возврата пользовательского объекта.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    – finishInteractiveTransition
    – cancelInteractiveTransition

  • finishInteractiveTransition () - finishInteractiveTransition

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

    Объявление

    Swift

    func finishInteractiveTransition()

    Objective C

    - (void)finishInteractiveTransition

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    – startInteractiveTransitionToCollectionViewLayout:completion:

  • cancelInteractiveTransition () - cancelInteractiveTransition

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

    Объявление

    Swift

    func cancelInteractiveTransition()

    Objective C

    - (void)cancelInteractiveTransition

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 7.0 и позже.

    См. также

    – startInteractiveTransitionToCollectionViewLayout:completion:

Перезагрузка содержания
  • reloadData () - reloadData

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

    Объявление

    Swift

    func reloadData()

    Objective C

    - (void)reloadData

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • reloadSections (_:) - reloadSections:

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

    Объявление

    Swift

    func reloadSections(_ sections: NSIndexSet)

    Objective C

    - (void)reloadSections:(NSIndexSet *)sections

    Параметры

    sections

    Индексы разделов для перезагрузки.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • reloadItemsAtIndexPaths (_:) - reloadItemsAtIndexPaths:

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

    Объявление

    Swift

    func reloadItemsAtIndexPaths(_ indexPaths: [AnyObject])

    Objective C

    - (void)reloadItemsAtIndexPaths:(NSArray *)indexPaths

    Параметры

    indexPaths

    Массив NSIndexPath объекты, идентифицирующие элементы, Вы хотите обновить.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Получение состояния представления набора
  • numberOfSections () - numberOfSections

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

    Объявление

    Swift

    func numberOfSections() -> Int

    Objective C

    - (NSInteger)numberOfSections

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

    Число разделов в представлении набора.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • numberOfItemsInSection (_:) - numberOfItemsInSection:

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

    Объявление

    Swift

    func numberOfItemsInSection(_ section: Int) -> Int

    Objective C

    - (NSInteger)numberOfItemsInSection:(NSInteger)section

    Параметры

    section

    Индекс раздела, для которого Вы хотите количество элементов.

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

    Число элементов в указанном разделе.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • visibleCells () - visibleCells

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

    Объявление

    Swift

    func visibleCells() -> [AnyObject]

    Objective C

    - (NSArray *)visibleCells

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

    Массив UICollectionViewCell объекты. Если никакие ячейки не видимы, этот метод возвращает пустой массив.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – indexPathsForVisibleItems

Вставка, перемещаясь и удаляя элементы
  • insertItemsAtIndexPaths (_:) - insertItemsAtIndexPaths:

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

    Объявление

    Swift

    func insertItemsAtIndexPaths(_ indexPaths: [AnyObject])

    Objective C

    - (void)insertItemsAtIndexPaths:(NSArray *)indexPaths

    Параметры

    indexPaths

    Массив NSIndexPath объекты, каждый из которых содержит индекс раздела и индекс элемента, в котором можно вставить новую ячейку. Этот параметр не должен быть nil.

    Обсуждение

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

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • moveItemAtIndexPath (_: toIndexPath:) - moveItemAtIndexPath:toIndexPath:

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

    Объявление

    Swift

    func moveItemAtIndexPath(_ indexPath: NSIndexPath, toIndexPath newIndexPath: NSIndexPath)

    Objective C

    - (void)moveItemAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath

    Параметры

    indexPath

    Индексный путь элемента Вы хотите переместиться. Этот параметр не должен быть nil.

    newIndexPath

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

    Обсуждение

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

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • deleteItemsAtIndexPaths (_:) - deleteItemsAtIndexPaths:

    Удаляет элементы в указанных индексных путях.

    Объявление

    Swift

    func deleteItemsAtIndexPaths(_ indexPaths: [AnyObject])

    Objective C

    - (void)deleteItemsAtIndexPaths:(NSArray *)indexPaths

    Параметры

    indexPaths

    Массив NSIndexPath объекты, каждый из которых содержит индекс раздела и индекс элемента для элемента, который Вы хотите удалить из представления набора. Этот параметр не должен быть nil.

    Обсуждение

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

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Вставка, перемещаясь и удаляя разделы
  • insertSections (_:) - insertSections:

    Вставляет новые разделы в указанных индексах.

    Объявление

    Swift

    func insertSections(_ sections: NSIndexSet)

    Objective C

    - (void)insertSections:(NSIndexSet *)sections

    Параметры

    sections

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

    Обсуждение

    Используйте этот метод для вставки одного или более разделов в представление набора. Этот метод добавляет разделы, и это до Вашего источника данных для создания отчетов о числе элементов в каждом разделе, когда спросили относительно информации. Представление набора тогда использует ту информацию для получения обновленных атрибутов макета для недавно вставленных разделов и элементов. Если вставки вызывают изменение в видимом содержании представления набора, те изменения анимированы в место.

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • moveSection (_: toSection:) - moveSection:toSection:

    Перемещает раздел от одного расположения до другого в представлении набора.

    Объявление

    Swift

    func moveSection(_ section: Int, toSection newSection: Int)

    Objective C

    - (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection

    Параметры

    section

    Индексный путь раздела Вы хотите переместиться. Этот параметр не должен быть nil.

    newSection

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

    Обсуждение

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

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • deleteSections (_:) - deleteSections:

    Удаляет разделы в указанных индексах.

    Объявление

    Swift

    func deleteSections(_ sections: NSIndexSet)

    Objective C

    - (void)deleteSections:(NSIndexSet *)sections

    Параметры

    sections

    Индексы разделов Вы хотите удалить. Этот параметр не должен быть nil.

    Обсуждение

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

    Можно также вызвать этот метод от блока, переданного performBatchUpdates:completion: метод, когда Вы хотите анимировать многократный, разделяет изменения на место одновременно. См. описание того метода для получения дополнительной информации.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Управление выбором
  • allowsSelection Свойство

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

    Объявление

    Swift

    var allowsSelection: Bool

    Objective C

    @property(nonatomic) BOOL allowsSelection

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    allowsMultipleSelection

  • allowsMultipleSelection Свойство

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

    Объявление

    Swift

    var allowsMultipleSelection: Bool

    Objective C

    @property(nonatomic) BOOL allowsMultipleSelection

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    allowsSelection

  • indexPathsForSelectedItems () - indexPathsForSelectedItems

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

    Объявление

    Swift

    func indexPathsForSelectedItems() -> [AnyObject]

    Objective C

    - (NSArray *)indexPathsForSelectedItems

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

    Массив NSIndexPath объекты, каждый из которых соответствует единственному выбранному пункту. Если нет никаких выбранных пунктов, этот метод возвращает пустой массив.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • selectItemAtIndexPath (_: animated:scrollPosition:) - selectItemAtIndexPath:animated:scrollPosition:

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

    Объявление

    Swift

    func selectItemAtIndexPath(_ indexPath: NSIndexPath?, animated animated: Bool, scrollPosition scrollPosition: UICollectionViewScrollPosition)

    Objective C

    - (void)selectItemAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated scrollPosition:(UICollectionViewScrollPosition)scrollPosition

    Параметры

    indexPath

    Индексный путь элемента для выбора. Указание nil поскольку этот параметр очищает текущий выбор.

    animated

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

    scrollPosition

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

    Обсуждение

    Если allowsSelection свойство NOfalse, вызов этого метода не имеет никакого эффекта. Если существует существующий выбор с различным индексным путем и allowsMultipleSelection свойство NOfalse, вызов этого метода заменяет предыдущий выбор.

    Этот метод не заставляет связанных с выбором методов делегата быть вызванными.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • deselectItemAtIndexPath (_: анимированный:) - deselectItemAtIndexPath:animated:

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

    Объявление

    Swift

    func deselectItemAtIndexPath(_ indexPath: NSIndexPath?, animated animated: Bool)

    Objective C

    - (void)deselectItemAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated

    Параметры

    indexPath

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

    animated

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

    Обсуждение

    Если allowsSelection свойство NOfalse, вызов этого метода не имеет никакого эффекта.

    Этот метод не заставляет связанных с выбором методов делегата быть вызванными.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Определение местоположения элементов в представлении набора
  • indexPathForItemAtPoint (_:) - indexPathForItemAtPoint:

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

    Объявление

    Swift

    func indexPathForItemAtPoint(_ point: CGPoint) -> NSIndexPath?

    Objective C

    - (NSIndexPath *)indexPathForItemAtPoint:(CGPoint)point

    Параметры

    point

    Точка в системе координат представления набора.

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

    Индексный путь элемента в указанной точке или nil если никакой элемент не был найден в указанной точке.

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • indexPathsForVisibleItems () - indexPathsForVisibleItems

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

    Объявление

    Swift

    func indexPathsForVisibleItems() -> [AnyObject]

    Objective C

    - (NSArray *)indexPathsForVisibleItems

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – visibleCells

  • indexPathForCell (_:) - indexPathForCell:

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

    Объявление

    Swift

    func indexPathForCell(_ cell: UICollectionViewCell) -> NSIndexPath?

    Objective C

    - (NSIndexPath *)indexPathForCell:(UICollectionViewCell *)cell

    Параметры

    cell

    Объект ячейки, индексный путь которого Вы хотите.

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

    Индексный путь ячейки или nil если указанная ячейка не находится в представлении набора.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • cellForItemAtIndexPath (_:) - cellForItemAtIndexPath:

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

    Объявление

    Swift

    func cellForItemAtIndexPath(_ indexPath: NSIndexPath) -> UICollectionViewCell?

    Objective C

    - (UICollectionViewCell *)cellForItemAtIndexPath:(NSIndexPath *)indexPath

    Параметры

    indexPath

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

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

    Объект ячейки в соответствующем индексном пути или nil если ячейка не видима или indexPath вне диапазона.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Получение информации макета
  • layoutAttributesForItemAtIndexPath (_:) - layoutAttributesForItemAtIndexPath:

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

    Объявление

    Swift

    func layoutAttributesForItemAtIndexPath(_ indexPath: NSIndexPath) -> UICollectionViewLayoutAttributes?

    Objective C

    - (UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath

    Параметры

    indexPath

    Индексный путь элемента.

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

  • layoutAttributesForSupplementaryElementOfKind (_: atIndexPath:) - layoutAttributesForSupplementaryElementOfKind:atIndexPath:

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

    Объявление

    Swift

    func layoutAttributesForSupplementaryElementOfKind(_ kind: String, atIndexPath indexPath: NSIndexPath) -> UICollectionViewLayoutAttributes?

    Objective C

    - (UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath

    Параметры

    kind

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

    indexPath

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

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

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

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Прокрутка элемента в представление
  • scrollToItemAtIndexPath (_: atScrollPosition:animated:) - scrollToItemAtIndexPath:atScrollPosition:animated:

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

    Объявление

    Swift

    func scrollToItemAtIndexPath(_ indexPath: NSIndexPath, atScrollPosition scrollPosition: UICollectionViewScrollPosition, animated animated: Bool)

    Objective C

    - (void)scrollToItemAtIndexPath:(NSIndexPath *)indexPath atScrollPosition:(UICollectionViewScrollPosition)scrollPosition animated:(BOOL)animated

    Параметры

    indexPath

    Индексный путь элемента для прокрутки в представление.

    scrollPosition

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

    animated

    Указать YEStrue анимировать поведение прокрутки или NOfalse скорректировать видимое содержание представления прокрутки сразу.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

Анимация многократных изменений в представлении набора
  • performBatchUpdates (_: завершение:) - performBatchUpdates:completion:

    Анимирует многократную вставку, удалите, перезагрузите, и операции пересылки как группа.

    Объявление

    Swift

    func performBatchUpdates(_ updates: (() -> Void)?, completion completion: ((Bool) -> Void)?)

    Objective C

    - (void)performBatchUpdates:(void (^)(void))updates completion:(void (^)(BOOL finished))completion

    Параметры

    updates

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

    completion

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

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.

    См. также

    – insertItemsAtIndexPaths:
    – moveItemAtIndexPath:toIndexPath:
    – deleteItemsAtIndexPaths:
    – insertSections:
    – moveSection:toSection:
    – deleteSections:

Типы данных

  • UICollectionViewLayoutInteractiveTransitionCompletion

    Блок завершения вызывают в конце интерактивного перехода для представления набора.

    Объявление

    Swift

    typealias UICollectionViewLayoutInteractiveTransitionCompletion = (Bool, Bool) -> Void

    Objective C

    typedef void(^UICollectionViewLayoutInteractiveTransitionCompletion)(BOOL completed, BOOL finish);

    Обсуждение

    Этот блок завершения берет следующие параметры:

    completed

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

    finish

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 7.0 и позже.

Константы
  • UICollectionViewScrollPosition

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

    Объявление

    Swift

    struct UICollectionViewScrollPosition : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var None: UICollectionViewScrollPosition { get } static var Top: UICollectionViewScrollPosition { get } static var CenteredVertically: UICollectionViewScrollPosition { get } static var Bottom: UICollectionViewScrollPosition { get } static var Left: UICollectionViewScrollPosition { get } static var CenteredHorizontally: UICollectionViewScrollPosition { get } static var Right: UICollectionViewScrollPosition { get } }

    Objective C

    enum { UICollectionViewScrollPositionNone = 0, UICollectionViewScrollPositionTop = 1 << 0, UICollectionViewScrollPositionCenteredVertically = 1 << 1, UICollectionViewScrollPositionBottom = 1 << 2, UICollectionViewScrollPositionLeft = 1 << 3, UICollectionViewScrollPositionCenteredHorizontally = 1 << 4, UICollectionViewScrollPositionRight = 1 << 5 }; typedef NSUInteger UICollectionViewScrollPosition;

    Константы

    • None

      UICollectionViewScrollPositionNone

      Не прокручивайте элемент в представление.

      Доступный в iOS 6.0 и позже.

    • Top

      UICollectionViewScrollPositionTop

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

      Доступный в iOS 6.0 и позже.

    • CenteredVertically

      UICollectionViewScrollPositionCenteredVertically

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

      Доступный в iOS 6.0 и позже.

    • Bottom

      UICollectionViewScrollPositionBottom

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

      Доступный в iOS 6.0 и позже.

    • Left

      UICollectionViewScrollPositionLeft

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

      Доступный в iOS 6.0 и позже.

    • CenteredHorizontally

      UICollectionViewScrollPositionCenteredHorizontally

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

      Доступный в iOS 6.0 и позже.

    • Right

      UICollectionViewScrollPositionRight

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

      Доступный в iOS 6.0 и позже.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

    Доступный в iOS 6.0 и позже.