UICollectionViewLayoutAttributes

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

NSObject
UICollectionViewLayoutAttributes

NSObject
UICollectionViewLayoutAttributes

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

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

Разделение на подклассы примечаний

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

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

Создание атрибутов макета

init (forCellWithIndexPath:) + layoutAttributesForCellWithIndexPath:

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

Объявление

Swift

convenience init(forCellWithIndexPath indexPath: NSIndexPath)

Objective C

+ (instancetype)layoutAttributesForCellWithIndexPath:(NSIndexPath *)indexPath

Параметры

indexPath

Индексный путь ячейки.

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

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

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    init (forSupplementaryViewOfKind:withIndexPath:)
    + layoutAttributesForSupplementaryViewOfKind:withIndexPath:

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

Объявление

Swift

convenience init(forSupplementaryViewOfKind elementKind: String, withIndexPath indexPath: NSIndexPath)

Objective C

+ (instancetype)layoutAttributesForSupplementaryViewOfKind:(NSString *)elementKind withIndexPath:(NSIndexPath *)indexPath

Параметры

`elementKind`	Строка, идентифицирующая тип дополнительного представления.
`indexPath`	Индексный путь представления.

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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


    
    init (forDecorationViewOfKind:withIndexPath:)
    + layoutAttributesForDecorationViewOfKind:withIndexPath:

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

Объявление

Swift

convenience init(forDecorationViewOfKind decorationViewKind: String, withIndexPath indexPath: NSIndexPath)

Objective C

+ (instancetype)layoutAttributesForDecorationViewOfKind:(NSString *)decorationViewKind withIndexPath:(NSIndexPath *)indexPath

Параметры

`decorationViewKind`	Добрый идентификатор для указанного представления художественного оформления.
`indexPath`	Индексный путь имел отношение к представлению художественного оформления.

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

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

Обсуждение

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

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Идентификация элемента, на который ссылаются,

indexPath Свойство

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

Объявление

Swift

var indexPath: NSIndexPath!

Objective C

@property(nonatomic, retain) NSIndexPath *indexPath

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Тип элемента. (только для чтения)

Объявление

Swift

var representedElementCategory: UICollectionElementCategory { get }

Objective C

@property(nonatomic, readonly) UICollectionElementCategory representedElementCategory

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Специфичный для расположения идентификатор для целевого представления. (только для чтения)

Объявление

Swift

var representedElementKind: String! { get }

Objective C

@property(nonatomic, readonly) NSString *representedElementKind

Обсуждение

Можно использовать значение в этом свойстве для идентификации определенной цели дополнительного представления или представления художественного оформления, связанного с атрибутами. Это свойство nil если representedElementCategory свойство содержит значение UICollectionElementCategoryCell.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Доступ к атрибутам макета

frame Свойство

Прямоугольник кадра элемента.

Объявление

Swift

var frame: CGRect

Objective C

@property(nonatomic) CGRect frame

Обсуждение

Прямоугольник кадра измерен в точках и указан в системе координат представления набора. Установка значения этого свойства также устанавливает значения center и size свойства.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Границы элемента.

Объявление

Swift

var bounds: CGRect

Objective C

@property(nonatomic) CGRect bounds

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Центральная точка элемента.

Объявление

Swift

var center: CGPoint

Objective C

@property(nonatomic) CGPoint center

Обсуждение

Центральная точка указана в системе координат представления набора. Установка значения этого свойства также обновляет источник прямоугольника в frame свойство.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Размер элемента.

Объявление

Swift

var size: CGSize

Objective C

@property(nonatomic) CGSize size

Обсуждение

Установка значения этого свойства также изменяет размер прямоугольника, возвращенного frame и boundsсвойства.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

3D преобразование элемента.

Объявление

Swift

var transform3D: CATransform3D

Objective C

@property(nonatomic) CATransform3D transform3D

Обсуждение

Присвоение преобразования кроме идентификационных данных преобразовывает к этим причинам свойства frame свойство, которое будет установлено в CGRectNull. Присвоение значения также заменяет значение в transform свойство с аффинной версией 3D преобразования Вы указываете.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Аффинное преобразование элемента

Объявление

Swift

var transform: CGAffineTransform

Objective C

@property(nonatomic) CGAffineTransform transform

Обсуждение

Присвоение преобразования кроме идентификационных данных преобразовывает к этим причинам свойства frame свойство, которое будет установлено в CGRectNull. Присвоение значения также заменяет значение в transform3D свойство с 3D версией аффинного преобразования Вы указываете.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Прозрачность элемента.

Объявление

Swift

var alpha: CGFloat

Objective C

@property(nonatomic) CGFloat alpha

Обсуждение

Возможные значения между 0,0 (прозрачны) и 1.0 (непрозрачный). Значение по умолчанию 1.0.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Указывает позицию элемента на оси z.

Объявление

Swift

var zIndex: Int

Objective C

@property(nonatomic) NSInteger zIndex

Обсуждение

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

Значение по умолчанию этого свойства 0.

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

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

Объявление

Swift

var hidden: Bool

Objective C

@property(nonatomic, getter=isHidden) BOOL hidden

Обсуждение

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

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

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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

Константы

UICollectionElementCategory
Константы, указывающие тип представления.

Объявление

Swift

enum UICollectionElementCategory : UInt { case Cell case SupplementaryView case DecorationView }

Objective C

typedef enum { UICollectionElementCategoryCell, UICollectionElementCategorySupplementaryView, UICollectionElementCategoryDecorationView } UICollectionElementCategory;

Константы
- Cell
  
  UICollectionElementCategoryCell
  
  Представление является ячейкой.
  
  Доступный в iOS 6.0 и позже.
- SupplementaryView
  
  UICollectionElementCategorySupplementaryView
  
  Представление является дополнительным представлением.
  
  Доступный в iOS 6.0 и позже.
- DecorationView
  
  UICollectionElementCategoryDecorationView
  
  Представление является представлением художественного оформления.
  
  Доступный в iOS 6.0 и позже.
Оператор импорта

Objective C

@import UIKit;

Swift

import UIKit

Доступность

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