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

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

Разработчик

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

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

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

UICollectionViewController

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UICollectionViewController класс представляет контроллер представления, содержание которого состоит из представления набора. Это реализует следующее поведение:

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

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

  • Когда представление набора собирается появиться впервые, контроллер представления набора перезагружает данные представления набора. Это также очищает текущий выбор каждый раз, когда представление выведено на экран. Можно изменить это поведение путем установки значения clearsSelectionOnViewWillAppear свойство к NOfalse.

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

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

Инициализация объекта UICollectionViewController
  • init (collectionViewLayout:) - initWithCollectionViewLayout:

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

    Объявление

    Swift

    init(collectionViewLayout layout: UICollectionViewLayout)

    Objective C

    - (instancetype)initWithCollectionViewLayout:(UICollectionViewLayout *)layout

    Параметры

    layout

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

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Получение представления набора
  • collectionView Свойство

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

    Объявление

    Swift

    var collectionView: UICollectionView?

    Objective C

    @property(nonatomic, retain) UICollectionView *collectionView

    Обсуждение

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • collectionViewLayout Свойство

    Объект расположения раньше инициализировал контроллер представления набора. (только для чтения)

    Объявление

    Swift

    var collectionViewLayout: UICollectionViewLayout! { get }

    Objective C

    @property(nonatomic, readonly) UICollectionViewLayout *collectionViewLayout

    Обсуждение

    Это свойство содержит объект расположения, который Вы передали initWithCollectionViewLayout: метод. Объект расположения в этом свойстве не обновляется для отражения изменений в самом представлении набора. Можно использовать это свойство для обращения к объекту расположения, который что Вы первоначально сконфигурировали представление набора для использования.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

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

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

    Объявление

    Swift

    var clearsSelectionOnViewWillAppear: Bool

    Objective C

    @property(nonatomic) BOOL clearsSelectionOnViewWillAppear

    Обсуждение

    Значение по умолчанию этого свойства YEStrue. Когда YEStrue, контроллер представления набора очищает текущий выбор представления набора, когда это получает a viewWillAppear: сообщение. Установка этого свойства к NOfalse сохраняет выбор.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Интеграция с контроллером навигации
  • useLayoutToLayoutNavigationTransitions Свойство

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

    Объявление

    Swift

    var useLayoutToLayoutNavigationTransitions: Bool

    Objective C

    @property(nonatomic, assign) BOOL useLayoutToLayoutNavigationTransitions

    Обсуждение

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

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

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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