iOS开发 UICollectionView属性介绍

原创 2016年05月31日 11:36:09


//通过一个布局策略初识化CollectionView
- (instancetype)initWithFrame:(CGRect)frame collectionViewLayout:(UICollectionViewLayout *)layout;

//获取和设置collection的layout
@property (nonatomic, strong) UICollectionViewLayout *collectionViewLayout;

//数据源和代理
@property (nonatomic, weak, nullable) id <UICollectionViewDelegate> delegate;
@property (nonatomic, weak, nullable) id <UICollectionViewDataSource> dataSource;

//从一个class或者xib文件进行cell(item)的注册
- (void)registerClass:(nullable Class)cellClass forCellWithReuseIdentifier:(NSString *)identifier;
- (void)registerNib:(nullable UINib *)nib forCellWithReuseIdentifier:(NSString *)identifier;


- (void)collectionView:(UICollectionView *)collectionView didHighlightItemAtIndexPath:(NSIndexPath *)indexPath//一点击item执行
{
     NSLog(@"-----------1------1----");
}
- (void)collectionView:(UICollectionView *)collectionView didUnhighlightItemAtIndexPath:(NSIndexPath *)indexPath//点击松开手后执行
{
          NSLog(@"-----------2------2----");
}
//下面两个方法与上面相似,这里注册的是头视图或者尾视图的类
//其中第二个参数是设置 头视图或者尾视图 系统为我们定义好了这两个字符串
//UIKIT_EXTERN NSString *const UICollectionElementKindSectionHeader NS_AVAILABLE_IOS(6_0);
//UIKIT_EXTERN NSString *const UICollectionElementKindSectionFooter NS_AVAILABLE_IOS(6_0);
- (void)registerClass:(nullable Class)viewClass forSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier;
- (void)registerNib:(nullable UINib *)nib forSupplementaryViewOfKind:(NSString *)kind withReuseIdentifier:(NSString *)identifier;

//这两个方法是从复用池中取出cell或者头尾视图
- (__kindof UICollectionViewCell *)dequeueReusableCellWithReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath;
- (__kindof UICollectionReusableView *)dequeueReusableSupplementaryViewOfKind:(NSString *)elementKind withReuseIdentifier:(NSString *)identifier forIndexPath:(NSIndexPath *)indexPath;

//设置是否允许选中 默认yes
@property (nonatomic) BOOL allowsSelection;

//设置是否允许多选 默认no
@property (nonatomic) BOOL allowsMultipleSelection;

//获取所有选中的item的位置信息
- (nullable NSArray<NSIndexPath *> *)indexPathsForSelectedItems;

//设置选中某一item,并使视图滑动到相应位置,scrollPosition是滑动位置的相关参数,如下:
/*
 typedef NS_OPTIONS(NSUInteger, UICollectionViewScrollPosition) {
 //无
 UICollectionViewScrollPositionNone                 = 0,
 //垂直布局时使用的 对应上中下
 UICollectionViewScrollPositionTop                  = 1 << 0,
 UICollectionViewScrollPositionCenteredVertically   = 1 << 1,
 UICollectionViewScrollPositionBottom               = 1 << 2,
 //水平布局时使用的  对应左中右
 UICollectionViewScrollPositionLeft                 = 1 << 3,
 UICollectionViewScrollPositionCenteredHorizontally = 1 << 4,
 UICollectionViewScrollPositionRight                = 1 << 5
 };
 */
- (void)selectItemAtIndexPath:(nullable NSIndexPath *)indexPath animated:(BOOL)animated scrollPosition:(UICollectionViewScrollPosition)scrollPosition;

//将某一item取消选中
- (void)deselectItemAtIndexPath:(NSIndexPath *)indexPath animated:(BOOL)animated;

//重新加载数据
- (void)reloadData;

//下面这两个方法,可以重新设置collection的布局,后面的方法多了一个布局完成后的回调,iOS7后可以用
//使用这两个方法可以产生非常炫酷的动画效果
- (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated;
- (void)setCollectionViewLayout:(UICollectionViewLayout *)layout animated:(BOOL)animated completion:(void (^ __nullable)(BOOL finished))completion NS_AVAILABLE_IOS(7_0);

//下面这些方法更加强大,我们可以对布局更改后的动画进行设置
//这个方法传入一个布局策略layout,系统会开始进行布局渲染,返回一个UICollectionViewTransitionLayout对象
//这个UICollectionViewTransitionLayout对象管理动画的相关属性,我们可以进行设置
- (UICollectionViewTransitionLayout *)startInteractiveTransitionToCollectionViewLayout:(UICollectionViewLayout *)layout completion:(nullable UICollectionViewLayoutInteractiveTransitionCompletion)completion NS_AVAILABLE_IOS(7_0);
//准备好动画设置后,我们需要调用下面的方法进行布局动画的展示,之后会调用上面方法的block回调
- (void)finishInteractiveTransition NS_AVAILABLE_IOS(7_0);
//调用这个方法取消上面的布局动画设置,之后也会进行上面方法的block回调
- (void)cancelInteractiveTransition NS_AVAILABLE_IOS(7_0);

//获取分区数
- (NSInteger)numberOfSections;

//获取某一分区的item数
- (NSInteger)numberOfItemsInSection:(NSInteger)section;

//下面两个方法获取item或者头尾视图的layout属性,这个UICollectionViewLayoutAttributes对象
//存放着布局的相关数据,可以用来做完全自定义布局,后面博客会介绍
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForItemAtIndexPath:(NSIndexPath *)indexPath;
- (nullable UICollectionViewLayoutAttributes *)layoutAttributesForSupplementaryElementOfKind:(NSString *)kind atIndexPath:(NSIndexPath *)indexPath;

//获取某一点所在的indexpath位置
- (nullable NSIndexPath *)indexPathForItemAtPoint:(CGPoint)point;

//获取某个cell所在的indexPath
- (nullable NSIndexPath *)indexPathForCell:(UICollectionViewCell *)cell;

//根据indexPath获取cell
- (nullable UICollectionViewCell *)cellForItemAtIndexPath:(NSIndexPath *)indexPath;

//获取所有可见cell的数组
- (NSArray<__kindof UICollectionViewCell *> *)visibleCells;

//获取所有可见cell的位置数组
- (NSArray<NSIndexPath *> *)indexPathsForVisibleItems;

//下面三个方法是iOS9中新添加的方法,用于获取头尾视图
- (UICollectionReusableView *)supplementaryViewForElementKind:(NSString *)elementKind atIndexPath:(NSIndexPath *)indexPath NS_AVAILABLE_IOS(9_0);
- (NSArray<UICollectionReusableView *> *)visibleSupplementaryViewsOfKind:(NSString *)elementKind NS_AVAILABLE_IOS(9_0);
- (NSArray<NSIndexPath *> *)indexPathsForVisibleSupplementaryElementsOfKind:(NSString *)elementKind NS_AVAILABLE_IOS(9_0);

//使视图滑动到某一位置,可以带动画效果
- (void)scrollToItemAtIndexPath:(NSIndexPath *)indexPath atScrollPosition:(UICollectionViewScrollPosition)scrollPosition animated:(BOOL)animated;

//下面这些方法用于动态添加,删除,移动某些分区获取items
- (void)insertSections:(NSIndexSet *)sections;
- (void)deleteSections:(NSIndexSet *)sections;
- (void)reloadSections:(NSIndexSet *)sections;
- (void)moveSection:(NSInteger)section toSection:(NSInteger)newSection;

- (void)insertItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
- (void)deleteItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
- (void)reloadItemsAtIndexPaths:(NSArray<NSIndexPath *> *)indexPaths;
- (void)moveItemAtIndexPath:(NSIndexPath *)indexPath toIndexPath:(NSIndexPath *)newIndexPath;

版权声明:本文为博主原创文章,未经博主允许不得转载。

UICollection scrollToItemAtIndexPath: 不工作的问题

scrollToItemAtIndexPath 不工作的原因
  • wtt692732757
  • wtt692732757
  • 2016年03月26日 23:02
  • 3618

iOS UICollectionView简单使用

NS_CLASS_AVAILABLE_IOS(6_0) @interface UICollectionView : UIScrollView
  • Apple_app
  • Apple_app
  • 2014年08月27日 11:35
  • 124248

IOS开发UI篇--UICollectionView初步入门

UICollectionView学习总结和Demo示例
  • yixiangboy
  • yixiangboy
  • 2015年11月06日 15:09
  • 2893

iOS UITableView 和 UICollectionView 设置默认选中状态

使用场景:进入页面时,就让某一行(单元)处于默认选中状态。 以UITableView 为例: 关键 API:- (void)selectRowAtIndexPath:(nullable NSInd...
  • sweet_521
  • sweet_521
  • 2015年12月30日 15:22
  • 9921

UICollectionView/UIScrollView滚动到指定的行

// 如果调用scrollToItemAtIndexPath不起作用 // 需要先调用layoutIfNeeded方法 [self layoutIfNeeded]; [_che...
  • yaoliangjun306
  • yaoliangjun306
  • 2016年12月20日 14:10
  • 4293

iOS UICollectionView基本属性 和 代理方法

//UICollectionViewLayout   //UICollectionViewLayout决定了UICollectionView如何显示在界面上,Apple提供了一个最简单的默认lay...
  • Flying_in_the_world
  • Flying_in_the_world
  • 2016年05月04日 09:39
  • 1629

UICollectionView常用属性

公司的UI图 在很多app中都有这样通用的页面,一直没有机会使用UICollectionView,只是简单的看过他的使用方法。今天公司美工出图,使用了他,并且遇到了好多的坑。记录一下...
  • KaSuperMen
  • KaSuperMen
  • 2016年08月30日 10:21
  • 1076

UICollectionView不能滑动特定位置的坑

如果collectionview使用 NSInteger row = [[self.passedParamsnonNullObjectForKey:@"selectedImageIndexP...
  • L_813815
  • L_813815
  • 2017年02月06日 11:08
  • 616

tableview或者collectionView列表滑动到顶部的三种方法

tableview或者collectionView列表滑动到顶部的三种方法 第一种:     collectionView.contentOffset=CGPointMake(0, 0); ...
  • suiyuechenglao
  • suiyuechenglao
  • 2016年09月02日 13:44
  • 3253

UICollectionView scrollToItemAtIndexPath 没有作用

http://stackoverflow.com/questions/19816184/uicollectionview-scrolltoitematindexpath I'm trying t...
  • jeffasd
  • jeffasd
  • 2016年11月29日 09:36
  • 1794
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:iOS开发 UICollectionView属性介绍
举报原因:
原因补充:

(最多只允许输入30个字)