UICollectionViewDelegate 类

定义

命名空间:

UIKit

程序集:

Xamarin.iOS.dll

用于接收与 相关的 UICollectionView通知。

[Foundation.Protocol]
[Foundation.Register("UICollectionViewDelegate", false)]
[ObjCRuntime.Introduced(ObjCRuntime.PlatformName.iOS, 6, 0, ObjCRuntime.PlatformArchitecture.All, null)]
public class UICollectionViewDelegate : Foundation.NSObject, IDisposable, UIKit.IUICollectionViewDelegate

type UICollectionViewDelegate = class
    inherit NSObject
    interface IUICollectionViewDelegate
    interface INativeObject
    interface IDisposable
    interface IUIScrollViewDelegate

继承

Object

NSObject

UICollectionViewDelegate

派生

UIKit.UICollectionViewDelegateFlowLayout

属性

ProtocolAttribute RegisterAttribute IntroducedAttribute

实现

INativeObject IDisposable IUICollectionViewDelegate IUIScrollViewDelegate

注解

调用 中 UICollectionViewDelegate 的方法以响应在关联的 UICollectionView中发生的事件。 若要使用此类，必须从该类派生并重写其 方法来响应事件。

虽然 UICollectionView 是 的 UIScrollView子类型，但 UICollectionViewDelegate 不是 的 UIScrollViewDelegate子类型。 尽管如此，许多方法都 UICollectionViewDelegate 反映了 和应用程序开发人员的这些 UIScrollViewDelegate 方法，可能会发现查阅该类的文档，以便更详细地讨论与滚动相关的方法。

类 UICollectionViewSource 提供了此类的替代方法，它 UICollectionViewDelegate 结合了 API 和 UICollectionViewDataSource API。 它通过 Source 属性提供。

选择和突出显示

在 中选择 UICollectionView 并突出显示将遵循以下顺序：

用户操作	UICollectionViewDelegate 方法	UICollectionViewCell 属性
未触及任何内容		Highlighted == false; Selected == false
在单元格中向下手指	调用 ShouldHighlightItem(UICollectionView, NSIndexPath)。 如果返回 false，则处理将停止。
	调用 ItemHighlighted(UICollectionView, NSIndexPath)。	Highlighted == true; Selected == false
手指向上	调用 ShouldSelectItem(UICollectionView, NSIndexPath)。 如果返回 false，则处理将停止。
	调用 ItemSelected(UICollectionView, NSIndexPath)。 调用 ItemUnhighlighted(UICollectionView, NSIndexPath)。	Highlighted == false; Selected == true

取消选择 遵循 UICollectionViewCell 类似的顺序：

用户操作	UICollectionViewDelegate 方法	UICollectionViewCell 属性
突出显示某些 UICollectionViewCell 内容时，没有任何接触。		Highlighted == false; Selected == true
手指点击单元格 (取消选择手势)	调用 ShouldDeselectItem(UICollectionView, NSIndexPath)。 如果返回 false，则处理将停止。
	调用 ItemDeselected(UICollectionView, NSIndexPath)。	Highlighted == false; Selected == false

构造函数

UICollectionViewDelegate()	默认构造函数初始化此类的新实例。
UICollectionViewDelegate(IntPtr)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。
UICollectionViewDelegate(NSObjectFlag)	用于调用派生类的构造函数，以跳过初始化并仅分配 对象。

属性

Class	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ClassHandle	此类的句柄。 (继承自 NSObject)
DebugDescription	此对象的开发人员有意义的说明。 (继承自 NSObject)
Description	对象的说明，即 ToString 的 Objective-C 版本。 (继承自 NSObject)
Handle	处理指向非托管对象表示形式的 (指针) 。 (继承自 NSObject)
IsDirectBinding	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
IsProxy	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
RetainCount	返回对象的当前 Objective-C 保留计数。 (继承自 NSObject)
Self	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Superclass	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
SuperHandle	用于表示此 NSObject 基类中方法的句柄。 (继承自 NSObject)
Zone	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)

方法

AddObserver(NSObject, NSString, NSKeyValueObservingOptions, IntPtr)	使用 NSString keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSObject, String, NSKeyValueObservingOptions, IntPtr)	使用 string keyPath) 注册在外部 (观察到的对象。   观察到的更改将调度到观察者的 对象 ObserveValue(NSString, NSObject, NSDictionary, IntPtr) 方法。 (继承自 NSObject)
AddObserver(NSString, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AddObserver(String, NSKeyValueObservingOptions, Action<NSObservedChange>)	注册一个对象，以便使用任意方法在外部观察到。 (继承自 NSObject)
AwakeFromNib()	从 nib 文件加载对象后调用。 重写程序必须调用 base。AwakeFromNib () 。 (继承自 NSObject)
BeginInvokeOnMainThread(Action)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
BeginInvokeOnMainThread(Selector, NSObject)	在主 UI 线程上异步调用指定的代码。 (继承自 NSObject)
Bind(NSString, NSObject, String, NSDictionary)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Bind(String, NSObject, String, NSDictionary)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
BindingInfo(String)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
BindingOptionDescriptions(String)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
BindingValueClass(String)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
CanFocusItem(UICollectionView, NSIndexPath)	中的 indexPath 项是否可以聚焦。
CanPerformAction(UICollectionView, Selector, NSIndexPath, NSObject)	此 UICollectionViewDelegate 是否可以对 UICollectionView 中的项执行指定操作。
CellDisplayingEnded(UICollectionView, UICollectionViewCell, NSIndexPath)	指示指定的单元格已从 UICollectionView 中删除。
CommitEditing()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
CommitEditing(NSObject, Selector, IntPtr)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ConformsToProtocol(IntPtr)	调用 以确定此对象是否实现指定的协议。 (继承自 NSObject)
Copy()	执行基础 Objective-C 对象的副本。 (继承自 NSObject)
DangerousAutorelease()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
DangerousRelease()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
DangerousRetain()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
DecelerationEnded(UIScrollView)	指示从滚动事件减速已完成。
DecelerationStarted(UIScrollView)	指示从滚动事件开始减速。
DidChange(NSKeyValueChange, NSIndexSet, NSString)	指示对多关系的索引发生了更改。 (继承自 NSObject)
DidChange(NSString, NSKeyValueSetMutationKind, NSSet)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
DidChangeAdjustedContentInset(UIScrollView)	在输入值更改时调用的方法。
DidChangeValue(String)	指示在指定的键上发生了更改。 (继承自 NSObject)
DidUpdateFocus(UICollectionView, UICollectionViewFocusUpdateContext, UIFocusAnimationCoordinator)	在焦点更改为新的 UIView后不久调用的委托方法。
DidZoom(UIScrollView)	指示已进行缩放。
Dispose()	释放 NSObject 对象使用的资源。 (继承自 NSObject)
Dispose(Boolean)	释放 NSObject 对象使用的资源。 (继承自 NSObject)
DoesNotRecognizeSelector(Selector)	指示此对象无法识别指定的选择器。 (继承自 NSObject)
DraggingEnded(UIScrollView, Boolean)	指示拖动已完成。
DraggingStarted(UIScrollView)	指示拖动已开始。
Equals(NSObject)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Equals(Object)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ExposedBindings()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetBindingInfo(NSString)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetBindingOptionDescriptions(NSString)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetBindingValueClass(NSString)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetDictionaryOfValuesFromKeys(NSString[])	检索指定键的值。 (继承自 NSObject)
GetHashCode()	为当前实例生成哈希代码。 (继承自 NSObject)
GetIndexPathForPreferredFocusedView(UICollectionView)	重写后，允许开发人员指定最初应接收焦点的项。
GetMethodForSelector(Selector)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetNativeField(String)	已过时. 用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetNativeHash()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
GetTargetContentOffset(UICollectionView, CGPoint)	重写后，开发人员可以修改布局和动画更改的内容偏移量。
GetTargetIndexPathForMove(UICollectionView, NSIndexPath, NSIndexPath)	重写后，允许开发人员修改移动项的最终位置。 (例如，禁止移动到特定 proposedIndexPath.)
Init()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
InitializeHandle(IntPtr)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
InitializeHandle(IntPtr, String)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Invoke(Action, Double)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Invoke(Action, TimeSpan)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
InvokeOnMainThread(Action)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
InvokeOnMainThread(Selector, NSObject)	在主 UI 线程上同步调用指定的代码。 (继承自 NSObject)
IsEqual(NSObject)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
IsKindOfClass(Class)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
IsMemberOfClass(Class)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ItemDeselected(UICollectionView, NSIndexPath)	指示已取消选择指定索引处的项。
ItemHighlighted(UICollectionView, NSIndexPath)	指示已突出显示指定的项。
ItemSelected(UICollectionView, NSIndexPath)	指示已选择指定索引处的项。
ItemUnhighlighted(UICollectionView, NSIndexPath)	指示指定索引处的项已删除其突出显示。
MarkDirty()	将常规对等对象 (IsDirectBinding 为 true) 提升为 toggleref 对象。 (继承自 NSObject)
MutableCopy()	创建指定 NSObject 的可变副本。 (继承自 NSObject)
ObjectDidEndEditing(NSObject)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ObserveValue(NSString, NSObject, NSDictionary, IntPtr)	指示指定 keyPath 相对于此对象的值已更改。 (继承自 NSObject)
PerformAction(UICollectionView, Selector, NSIndexPath, NSObject)	对 UICollectionView 中的项执行指定的操作。
PerformSelector(Selector)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PerformSelector(Selector, NSObject)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double)	在当前实例上调用选择器，如果 obj 不为 null，则将其作为单个参数传递。 (继承自 NSObject)
PerformSelector(Selector, NSObject, Double, NSString[])	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PerformSelector(Selector, NSObject, NSObject)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PerformSelector(Selector, NSThread, NSObject, Boolean, NSString[])	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
PrepareForInterfaceBuilder()	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
RemoveObserver(NSObject, NSString)	阻止指定的观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, NSString, IntPtr)	阻止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String)	阻止指定的观察程序接收指定 keyPath 的更改值的进一步通知。 (继承自 NSObject)
RemoveObserver(NSObject, String, IntPtr)	阻止指定的观察程序接收指定 keyPath 和上下文的更改值的进一步通知。 (继承自 NSObject)
RespondsToSelector(Selector)	此对象是否识别指定的选择器。 (继承自 NSObject)
ScrollAnimationEnded(UIScrollView)	指示与滚动事件相关的动画已完成。
Scrolled(UIScrollView)	指示发生了滚动。
ScrolledToTop(UIScrollView)	指示 UICollectionView 已滚动到其开头。
SetNativeField(String, NSObject)	已过时. 用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
SetNilValueForKey(NSString)	将指定键的值设置为 null。 (继承自 NSObject)
SetValueForKey(NSObject, NSString)	将键指定的属性的值设置为指定值。 (继承自 NSObject)
SetValueForKeyPath(IntPtr, NSString)	创建非托管对象的托管表示形式时使用的构造函数;由运行时调用。 (继承自 NSObject)
SetValueForKeyPath(NSObject, NSString)	设置可使用键路径访问的属性的值。 (继承自 NSObject)
SetValueForUndefinedKey(NSObject, NSString)	指示尝试将值写入未定义的键。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
SetValuesForKeysWithDictionary(NSDictionary)	将此 NSObject 的值设置为指定字典中的值。 (继承自 NSObject)
ShouldDeselectItem(UICollectionView, NSIndexPath)	是否应取消选择指定的项。
ShouldHighlightItem(UICollectionView, NSIndexPath)	在跟踪期间是否应突出显示指定的项。
ShouldScrollToTop(UIScrollView)	UICollectionView 是否应滚动到其开头。
ShouldSelectItem(UICollectionView, NSIndexPath)	是否应选择指定的项。
ShouldShowMenu(UICollectionView, NSIndexPath)	是否应为指定项显示操作菜单。
ShouldSpringLoadItem(UICollectionView, NSIndexPath, IUISpringLoadedInteractionContext)	调用的方法，用于指示标识的项是否应在指定上下文中弹载。
ShouldUpdateFocus(UICollectionView, UICollectionViewFocusUpdateContext)	在失去或接收焦点的 collectionView 单元格之前调用。 如果任一焦点环境返回 false，则取消焦点更新。
SupplementaryViewDisplayingEnded(UICollectionView, UICollectionReusableView, NSString, NSIndexPath)	指示指定的补充视图已从 UICollectionView 中删除。
ToString()	返回当前实例值的字符串表示形式。 (继承自 NSObject)
TransitionLayout(UICollectionView, UICollectionViewLayout, UICollectionViewLayout)	在所选布局之间移动时使用的自定义过渡布局。
Unbind(NSString)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
Unbind(String)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
ValueForKey(NSString)	返回与指定键关联的属性的值。 (继承自 NSObject)
ValueForKeyPath(NSString)	返回可使用键路径访问的属性的值。 (继承自 NSObject)
ValueForUndefinedKey(NSString)	指示尝试读取未定义键的值。 如果未重写，则引发 NSUndefinedKeyException。 (继承自 NSObject)
ViewForZoomingInScrollView(UIScrollView)	缩放即将发生时使用的 UIView。
WillChange(NSKeyValueChange, NSIndexSet, NSString)	指示指定键中指定索引的值即将更改。 (继承自 NSObject)
WillChange(NSString, NSKeyValueSetMutationKind, NSSet)	用于接收与 相关的 UICollectionView通知。 (继承自 NSObject)
WillChangeValue(String)	指示指定键的值即将更改。 (继承自 NSObject)
WillDisplayCell(UICollectionView, UICollectionViewCell, NSIndexPath)	cell即将显示 。
WillDisplaySupplementaryView(UICollectionView, UICollectionReusableView, String, NSIndexPath)	即将显示补充 view 。
WillEndDragging(UIScrollView, CGPoint, CGPoint)	指示拖动即将完成。
ZoomingEnded(UIScrollView, UIView, nfloat)	指示缩放已完成。
ZoomingStarted(UIScrollView, UIView)	指示缩放已开始。

扩展方法

GetDebugDescription(INSObjectProtocol)	用于接收与 相关的 UICollectionView通知。
GetAccessibilityCustomRotors(NSObject)	获取适用于 this 对象的 对象的数组UIAccessibilityCustomRotor。
SetAccessibilityCustomRotors(NSObject, UIAccessibilityCustomRotor[])	设置适用于 this 对象的 对象数组UIAccessibilityCustomRotor。
CanFocusItem(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	中的 indexPath 项是否可以聚焦。
CanPerformAction(IUICollectionViewDelegate, UICollectionView, Selector, NSIndexPath, NSObject)	指定的 indexPath 中的单元格是否支持指定的操作。
CellDisplayingEnded(IUICollectionViewDelegate, UICollectionView, UICollectionViewCell, NSIndexPath)	指示已删除指定 indexPath 处的单元格。
DidUpdateFocus(IUICollectionViewDelegate, UICollectionView, UICollectionViewFocusUpdateContext, UIFocusAnimationCoordinator)	指示焦点已更改，详见 context。
GetIndexPathForPreferredFocusedView(IUICollectionViewDelegate, UICollectionView)	重写时，允许开发人员指定最初应接收焦点的项。
GetTargetContentOffset(IUICollectionViewDelegate, UICollectionView, CGPoint)	重写时，允许开发人员修改布局和动画更改的内容偏移量。
GetTargetIndexPathForMove(IUICollectionViewDelegate, UICollectionView, NSIndexPath, NSIndexPath)	重写时，允许开发人员修改移动项的最终位置。 (例如，禁止移动到特定的 proposedIndexPath.)
ItemDeselected(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指示已取消选择指定 indexPath 处的单元格。
ItemHighlighted(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指示指定 indexPath 处的单元格已突出显示。
ItemSelected(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指示已选择指定 indexPath 处的单元格。
ItemUnhighlighted(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指示指定 indexPath 处的单元格已取消突出显示。
PerformAction(IUICollectionViewDelegate, UICollectionView, Selector, NSIndexPath, NSObject)	指定 indexPath 处的单元格是否支持指定的“复制”或“粘贴”操作。
ShouldDeselectItem(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指定 indexPath 处的单元格是否应允许取消选择自身。
ShouldHighlightItem(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指定 indexPath 处的单元格是否应允许突出显示自身。
ShouldSelectItem(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指定 indexPath 处的单元格是否允许自己被选中。
ShouldShowMenu(IUICollectionViewDelegate, UICollectionView, NSIndexPath)	指定 indexPath 处的单元格是否应显示“操作”菜单。
ShouldSpringLoadItem(IUICollectionViewDelegate, UICollectionView, NSIndexPath, IUISpringLoadedInteractionContext)	调用以指示标识的项是否应在指定上下文中 springload 的方法。
ShouldUpdateFocus(IUICollectionViewDelegate, UICollectionView, UICollectionViewFocusUpdateContext)	重写时，允许开发人员阻止 中指定的 context焦点更改。
SupplementaryViewDisplayingEnded(IUICollectionViewDelegate, UICollectionView, UICollectionReusableView, NSString, NSIndexPath)	指示已删除指定 indexPath 处的补充视图。
TransitionLayout(IUICollectionViewDelegate, UICollectionView, UICollectionViewLayout, UICollectionViewLayout)	从指定的 fromLayout 移动到 toLayout 时要使用的 UICollectionViewTransitionLayout。
WillDisplayCell(IUICollectionViewDelegate, UICollectionView, UICollectionViewCell, NSIndexPath)	cell即将显示 。
WillDisplaySupplementaryView(IUICollectionViewDelegate, UICollectionView, UICollectionReusableView, String, NSIndexPath)	即将显示补充 view 。
DecelerationEnded(IUIScrollViewDelegate, UIScrollView)	指示与滚动事件相关的减速已结束。
DecelerationStarted(IUIScrollViewDelegate, UIScrollView)	指示滚动事件的减速已开始。
DidChangeAdjustedContentInset(IUIScrollViewDelegate, UIScrollView)	当嵌入值更改时调用的方法。
DidZoom(IUIScrollViewDelegate, UIScrollView)	指示指定的 scrollView 已缩放。
DraggingEnded(IUIScrollViewDelegate, UIScrollView, Boolean)	指示拖动已完成。
DraggingStarted(IUIScrollViewDelegate, UIScrollView)	指示拖动已开始。
ScrollAnimationEnded(IUIScrollViewDelegate, UIScrollView)	指示与滚动相关的所有动画都已完成。
Scrolled(IUIScrollViewDelegate, UIScrollView)	指示指定的 scrollView 已滚动。
ScrolledToTop(IUIScrollViewDelegate, UIScrollView)	指示指定的 scrollView 的滚动已在顶部结束。
ShouldScrollToTop(IUIScrollViewDelegate, UIScrollView)	是否应允许滚动到 scrollView 的开头。
ViewForZoomingInScrollView(IUIScrollViewDelegate, UIScrollView)	请求缩放时要缩放的 UIView。
WillEndDragging(IUIScrollViewDelegate, UIScrollView, CGPoint, CGPoint)	指示拖动即将结束。
ZoomingEnded(IUIScrollViewDelegate, UIScrollView, UIView, nfloat)	指示缩放已完成。
ZoomingStarted(IUIScrollViewDelegate, UIScrollView, UIView)	指示缩放已开始。

另请参阅

• UICollectionViewSource
• 集合视图简介
• Apple 文档 UICollectionViewDelegate