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

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

Разработчик

Фото ссылка платформы ссылка класса PHCollectionList

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

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

PHCollectionList

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

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

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

Swift

import Photos

Objective C

@import Photos;

Доступность

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

A PHCollectionList объект представляет группу наборов актива. Списки набора включают верхние уровни иерархии Моментов, показанной в фото приложении — кластеры момента и годы момента — а также папки, группирующиеся создаваемые пользователями альбомы или умные альбомы. Списки набора могут содержать также PHAssetCollection объекты или другие списки набора.

В фото платформе объекты коллекции (включая наборы актива) непосредственно не ссылаются на свои задействованные объекты, и нет никаких других объектов этого непосредственно ссылочные объекты коллекции. Для получения элементов списка набора выберите их с a PHCollection метод класса такой как fetchCollectionsInCollectionList:options:. Для нахождения объектов в корне иерархии списка набора (таких как папки альбома без родительских папок) используйте fetchTopLevelUserCollectionsWithOptions: метод.

Как активы и наборы актива, списки набора являются неизменными. Для создания переименуйте или удалите списки набора, или добавить, удалить, или перестроить элементы в списке набора, создать a PHCollectionListChangeRequest объект в фото библиотеке изменяет блок. Для получения дополнительной информации при использовании запросов на изменение и блоков изменения для обновления фото библиотеки посмотрите Ссылку класса PHPhotoLibrary.

Выборка списков набора
  • fetchCollectionListsContainingCollection (_: опции:) + fetchCollectionListsContainingCollection:options:

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

    Объявление

    Swift

    class func fetchCollectionListsContainingCollection(_ collection: PHCollection!, options options: PHFetchOptions!) -> PHFetchResult!

    Objective C

    + (PHFetchResult *)fetchCollectionListsContainingCollection:(PHCollection *)collection options:(PHFetchOptions *)options

    Параметры

    collection

    Набор актива или другой список набора.

    options

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

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

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

    Обсуждение

    Различные виды наборов имеют различные возможности включения. Например, набор актива, тип которого PHAssetCollectionTypeAlbum может содержаться в папке или не иметь никакого содержащего список набора. Папка, в свою очередь, может содержаться в другой папке. Набор актива, тип которого PHAssetCollectionTypeMoment всегда содержится двумя списками набора: кластер момента и год момента.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • fetchCollectionListsWithLocalIdentifiers (_: опции:) + fetchCollectionListsWithLocalIdentifiers:options:

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

    Объявление

    Swift

    class func fetchCollectionListsWithLocalIdentifiers(_ identifiers: [AnyObject]!, options options: PHFetchOptions!) -> PHFetchResult!

    Objective C

    + (PHFetchResult *)fetchCollectionListsWithLocalIdentifiers:(NSArray *)identifiers options:(PHFetchOptions *)options

    Параметры

    identifiers

    Массив NSString объекты, каждый localIdentifier строка списка набора.

    options

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

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

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • fetchCollectionListsWithType (_: subtype:options:) + fetchCollectionListsWithType:subtype:options:

    Получает списки набора указанного типа.

    Объявление

    Swift

    class func fetchCollectionListsWithType(_ collectionListType: PHCollectionListType, subtype subtype: PHCollectionListSubtype, options options: PHFetchOptions!) -> PHFetchResult!

    Objective C

    + (PHFetchResult *)fetchCollectionListsWithType:(PHCollectionListType)collectionListType subtype:(PHCollectionListSubtype)subtype options:(PHFetchOptions *)options

    Параметры

    collectionListType

    Тип списка набора. Посмотрите PHCollectionListType.

    subtype

    Подтип списка набора. Посмотрите PHCollectionListSubtype.

    options

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

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

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

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • fetchMomentListsWithSubtype (_: containingMoment:options:) + fetchMomentListsWithSubtype:containingMoment:options:

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

    Объявление

    Swift

    class func fetchMomentListsWithSubtype(_ momentListSubtype: PHCollectionListSubtype, containingMoment moment: PHAssetCollection!, options options: PHFetchOptions!) -> PHFetchResult!

    Objective C

    + (PHFetchResult *)fetchMomentListsWithSubtype:(PHCollectionListSubtype)momentListSubtype containingMoment:(PHAssetCollection *)moment options:(PHFetchOptions *)options

    Параметры

    momentListSubtype

    Тип списка момента, также PHCollectionListSubtypeMomentListCluster или PHCollectionListSubtypeMomentListYear. Посмотрите PHCollectionListSubtype.

    moment

    Набор актива, тип которого PHAssetCollectionTypeMoment.

    options

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

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

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

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • fetchMomentListsWithSubtype (_: опции:) + fetchMomentListsWithSubtype:options:

    Получает списки набора указанного типа списка момента.

    Объявление

    Swift

    class func fetchMomentListsWithSubtype(_ momentListSubtype: PHCollectionListSubtype, options options: PHFetchOptions!) -> PHFetchResult!

    Objective C

    + (PHFetchResult *)fetchMomentListsWithSubtype:(PHCollectionListSubtype)momentListSubtype options:(PHFetchOptions *)options

    Параметры

    momentListSubtype

    Тип списка момента, также PHCollectionListSubtypeMomentListCluster или PHCollectionListSubtypeMomentListYear. Посмотрите PHCollectionListSubtype.

    options

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

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

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

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Чтение метаданных списка набора
  • collectionListType Свойство

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

    Объявление

    Swift

    var collectionListType: PHCollectionListType { get }

    Objective C

    @property(nonatomic, assign, readonly) PHCollectionListType collectionListType

    Обсуждение

    Список набора может представлять верхний уровень иерархии Моментов, показанной в фото приложении, папка, содержащая альбомы или умную папку, синхронизировавшую от iPhoto. Посмотрите PHCollectionListType.

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • collectionListSubtype Свойство

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

    Объявление

    Swift

    var collectionListSubtype: PHCollectionListSubtype { get }

    Objective C

    @property(nonatomic, assign, readonly) PHCollectionListSubtype collectionListSubtype

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • startDate Свойство

    Самая ранняя дата создания среди всех активов в списке набора. (только для чтения)

    Объявление

    Swift

    var startDate: NSDate! { get }

    Objective C

    @property(nonatomic, strong, readonly) NSDate *startDate

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • endDate Свойство

    Последняя дата создания среди всех активов в списке набора. (только для чтения)

    Объявление

    Swift

    var endDate: NSDate! { get }

    Objective C

    @property(nonatomic, strong, readonly) NSDate *endDate

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • localizedLocationNames Свойство

    Имена расположений, сгруппированных набором (массив NSString объекты). (только для чтения)

    Объявление

    Swift

    var localizedLocationNames: [AnyObject]! { get }

    Objective C

    @property(nonatomic, strong, readonly) NSArray *localizedLocationNames

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Создание временных списков набора
  • transientCollectionListWithCollections (_: заголовок:) + transientCollectionListWithCollections:title:

    Создает временный список набора, содержащий указанные наборы актива.

    Объявление

    Swift

    class func transientCollectionListWithCollections(_ collections: [AnyObject]!, title title: String!) -> PHCollectionList!

    Objective C

    + (PHCollectionList *)transientCollectionListWithCollections:(NSArray *)collections title:(NSString *)title

    Параметры

    collections

    Массив PHAssetCollection объекты.

    title

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

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

    Новый список набора.

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • transientCollectionListWithCollectionsFetchResult (_: заголовок:) + transientCollectionListWithCollectionsFetchResult:title:

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

    Объявление

    Swift

    class func transientCollectionListWithCollectionsFetchResult(_ fetchResult: PHFetchResult!, title title: String!) -> PHCollectionList!

    Objective C

    + (PHCollectionList *)transientCollectionListWithCollectionsFetchResult:(PHFetchResult *)fetchResult title:(NSString *)title

    Параметры

    fetchResult

    Результат выборки, содержащий один или больше PHAssetCollection объекты.

    title

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

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

    Новый список набора.

    Обсуждение

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

Константы
  • PHCollectionListType

    Главные различия между видами списка набора, используемого collectionListType свойство и fetchCollectionListsWithType:subtype:options: метод.

    Объявление

    Swift

    enum PHCollectionListType : Int { case MomentList case Folder case SmartFolder }

    Objective C

    typedef enum : NSInteger { PHCollectionListTypeMomentList, PHCollectionListTypeFolder, PHCollectionListTypeSmartFolder, } PHCollectionListType;

    Константы

    • MomentList

      PHCollectionListTypeMomentList

      Группа наборов актива типа PHAssetCollectionTypeMoment.

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

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

    • Folder

      PHCollectionListTypeFolder

      Папка, содержащая наборы актива типа PHAssetCollectionTypeAlbum или PHAssetCollectionTypeSmartAlbum.

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

    • SmartFolder

      PHCollectionListTypeSmartFolder

      Умная папка, синхронизировавшая к устройству от.

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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

  • PHCollectionListSubtype

    Главные различия между видами списка набора, используемого collectionListSubtype свойство и fetchCollectionListsWithType:subtype:options:, fetchMomentListsWithSubtype:containingMoment:options:, и fetchMomentListsWithSubtype:options: методы.

    Объявление

    Swift

    enum PHCollectionListSubtype : Int { case MomentListCluster case MomentListYear case RegularFolder case SmartFolderEvents case SmartFolderFaces case Any }

    Objective C

    typedef enum : NSInteger { PHCollectionListSubtypeMomentListCluster = 1, PHCollectionListSubtypeMomentListYear = 2, PHCollectionListSubtypeRegularFolder = 100, PHCollectionListSubtypeSmartFolderEvents = 200, PHCollectionListSubtypeSmartFolderFaces = 201, PHCollectionListSubtypeAny = NSIntegerMax } PHCollectionListSubtype;

    Константы

    • MomentListCluster

      PHCollectionListSubtypeMomentListCluster

      Список набора является кластером момента, группируя несколько связанных моментов.

      Этот подтип применяется только к спискам набора, тип которых PHCollectionListTypeMomentList.

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

    • MomentListYear

      PHCollectionListSubtypeMomentListYear

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

      Этот подтип применяется только к спискам набора, тип которых PHCollectionListTypeMomentList.

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

    • RegularFolder

      PHCollectionListSubtypeRegularFolder

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

      Этот подтип применяется только к спискам набора, тип которых PHCollectionListTypeFolder.

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

    • SmartFolderEvents

      PHCollectionListSubtypeSmartFolderEvents

      Список набора является умной папкой, содержащей одно или более Событий, синхронизировавших от iPhoto.

      Этот подтип применяется только к спискам набора, тип которых PHCollectionListTypeSmartFolder.

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

    • SmartFolderFaces

      PHCollectionListSubtypeSmartFolderFaces

      Список набора является умной папкой, содержащей одну или более Поверхностей, синхронизировавших от iPhoto.

      Этот подтип применяется только к спискам набора, тип которых PHCollectionListTypeSmartFolder.

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

    • Any

      PHCollectionListSubtypeAny

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

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

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

    Objective C

    @import Photos;

    Swift

    import Photos

    Доступность

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