28.UITableView类详解

UITableView类详解

@available(iOS 2.0, *)
public class UITableView : UIScrollView, NSCoding {

public init(frame: CGRect, style: UITableViewStyle)
public init?(coder aDecoder: NSCoder)

// 获取风格Plain或Grouped
public var style: UITableViewStyle { get }
// dataSource
weak public var dataSource: UITableViewDataSource?
// delegate
weak public var delegate: UITableViewDelegate?
// 行高,没设置的话使用默认的高度
public var rowHeight: CGFloat
// 分组的头的高度,没设置的话使用默认高度
public var sectionHeaderHeight: CGFloat
// 分组的底部的高度, 没有设置的话使用默认值
public var sectionFooterHeight: CGFloat
// 预估的行高, 默认值为0
@available(iOS 7.0, *)
public var estimatedRowHeight: CGFloat
// 预估的分组头部高度,默认为0
@available(iOS 7.0, *)
public var estimatedSectionHeaderHeight: CGFloat
// 预估的分组头部高度,默认为0
@available(iOS 7.0, *)
public var estimatedSectionFooterHeight: CGFloat
// 分割线的边界
@available(iOS 7.0, *)
public var separatorInset: UIEdgeInsets

// 背景View
@available(iOS 3.2, *)
public var backgroundView: UIView? // the background view will be automatically resized to track the size of the table view.  this will be placed as a subview of the table view behind all cells and headers/footers.  default may be non-nil for some devices.

// Data
// 重新加载数据
public func reloadData()

// 刷新索引栏
@available(iOS 3.0, *)
public func reloadSectionIndexTitles() // reloads the index bar.

// Info
// 分组数
public var numberOfSections: Int { get }
// 分组的行数
public func numberOfRowsInSection(section: Int) -> Int

// 分组的rect, 包括header,footer和所有的rows
public func rectForSection(section: Int) -> CGRect
// 分组中的header的rect
public func rectForHeaderInSection(section: Int) -> CGRect
// 分组中的footer的rect
public func rectForFooterInSection(section: Int) -> CGRect
// 分组中的row的rect
public func rectForRowAtIndexPath(indexPath: NSIndexPath) -> CGRect

// 指定的点所处的indexPath, 如果不在tableview的任何row中则返回nil
public func indexPathForRowAtPoint(point: CGPoint) -> NSIndexPath?
// 返回指定的cell, 如果该cell不可见则返回nil
public func indexPathForCell(cell: UITableViewCell) -> NSIndexPath?
// 指定的rect中包含的rows, 如果rect无效则返回nil
public func indexPathsForRowsInRect(rect: CGRect) -> [NSIndexPath]? // returns nil if rect not valid

// 返回指定的cell, 如果cell不可见或indexPath不在range范围内,则返回nil
public func cellForRowAtIndexPath(indexPath: NSIndexPath) -> UITableViewCell?
// 获得可见cell
public var visibleCells: [UITableViewCell] { get }
// 可见行对应的indexPath
public var indexPathsForVisibleRows: [NSIndexPath]? { get }

// 获取指定分组的headerView
@available(iOS 6.0, *)
public func headerViewForSection(section: Int) -> UITableViewHeaderFooterView?
// 获得指定分组的footerView
@available(iOS 6.0, *)
public func footerViewForSection(section: Int) -> UITableViewHeaderFooterView?

// 滑动indexPath的指定的row的位置, scrollPosition可为None/Top/Middle/Bottom
public func scrollToRowAtIndexPath(indexPath: NSIndexPath, atScrollPosition scrollPosition: UITableViewScrollPosition, animated: Bool)
// 滑动到距离选中行最近的位置
public func scrollToNearestSelectedRowAtScrollPosition(scrollPosition: UITableViewScrollPosition, animated: Bool)

// Row insertion/deletion/reloading.

// 允许插入/删除多个rows和sections的同时运行动画
public func beginUpdates()
// 只能在beginUpdates和endUpdates()之间调用插入/删除/重新加载数据方法或更改编辑状态, 否则可能无效
public func endUpdates() // only call insert/delete/reload calls or change the editing state inside an update block.  otherwise things like row count, etc. may be invalid.

// 插入多个分组
public func insertSections(sections: NSIndexSet, withRowAnimation animation: UITableViewRowAnimation)
// 删除多个分组
public func deleteSections(sections: NSIndexSet, withRowAnimation animation: UITableViewRowAnimation)
// 重新加载多个分组
@available(iOS 3.0, *)
public func reloadSections(sections: NSIndexSet, withRowAnimation animation: UITableViewRowAnimation)
// 移动分组
@available(iOS 5.0, *)
public func moveSection(section: Int, toSection newSection: Int)

// 在indexPaths中插入多个rows
public func insertRowsAtIndexPaths(indexPaths: [NSIndexPath], withRowAnimation animation: UITableViewRowAnimation)
// 在indexPaths中删除多个rows
public func deleteRowsAtIndexPaths(indexPaths: [NSIndexPath], withRowAnimation animation: UITableViewRowAnimation)
// 重新加载多个indexPath的行
@available(iOS 3.0, *)
public func reloadRowsAtIndexPaths(indexPaths: [NSIndexPath], withRowAnimation animation: UITableViewRowAnimation)
// 移动行
@available(iOS 5.0, *)
public func moveRowAtIndexPath(indexPath: NSIndexPath, toIndexPath newIndexPath: NSIndexPath)

// Editing. When set, rows show insert/delete/reorder controls based on data source queries
// 编辑模式, 默认为false, 没有动画效果
public var editing: Bool
// 和上面的差不多, 但是它可以设置动画
public func setEditing(editing: Bool, animated: Bool)

// 默认为true, 在非编辑模式时行是否可以选中
@available(iOS 3.0, *)
public var allowsSelection: Bool
// 默认为false, 在编辑模式时行是否可以被选中
public var allowsSelectionDuringEditing: Bool

// 默认为false, 在非编辑模式是否允许选中多个行
@available(iOS 5.0, *)
public var allowsMultipleSelection: Bool
// 默认为false, 在编辑模式是否允许选中多个行
@available(iOS 5.0, *)
public var allowsMultipleSelectionDuringEditing: Bool

// Selection

// 返回nil或选中的行对应的indexPath
public var indexPathForSelectedRow: NSIndexPath? { get }
// 返回nil或选中的多个行对应的indexPath数组
@available(iOS 5.0, *)
public var indexPathsForSelectedRows: [NSIndexPath]? { get }

// 选中指定的行
public func selectRowAtIndexPath(indexPath: NSIndexPath?, animated: Bool, scrollPosition: UITableViewScrollPosition)
// 取消选中指定的行
public func deselectRowAtIndexPath(indexPath: NSIndexPath, animated: Bool)

// Appearance

public var sectionIndexMinimumDisplayRowCount: Int // show special section index list on right when row count reaches this value. default is 0
// 当被选中时分组索引的文本颜色
@available(iOS 6.0, *)
public var sectionIndexColor: UIColor? // color used for text of the section index
// 当没被触摸时分组索引的背景颜色
@available(iOS 7.0, *)
public var sectionIndexBackgroundColor: UIColor? // the background color of the section index while not being touched
// 分组索引被触摸时的颜色
@available(iOS 6.0, *)
public var sectionIndexTrackingBackgroundColor: UIColor? // the background color of the section index while it is being touched

// 分隔线的类型:None/SingleLine/SingleLineEtched(只能用在grouped风格的UITableView中), 默认是SingleLine
public var separatorStyle: UITableViewCellSeparatorStyle
// 分割线颜色, 默认是灰色
public var separatorColor: UIColor?
// 分割线特效
@available(iOS 8.0, *)
@NSCopying public var separatorEffect: UIVisualEffect?

// 判断是否根据内容留空白
@available(iOS 9.0, *)
public var cellLayoutMarginsFollowReadableWidth: Bool // if cell margins are derived from the width of the readableContentGuide.

// 默认为nil, tableView的headerView,注意它和section header是不同的
public var tableHeaderView: UIView?
// 默认为nil, tableView的footerView, 注意它和section footer是不同的
public var tableFooterView: UIView?

// 重用cell
public func dequeueReusableCellWithIdentifier(identifier: String) -> UITableViewCell? // Used by the delegate to acquire an already allocated cell, in lieu of allocating a new one.
@available(iOS 6.0, *)
public func dequeueReusableCellWithIdentifier(identifier: String, forIndexPath indexPath: NSIndexPath) -> UITableViewCell // newer dequeue method guarantees a cell is returned and resized properly, assuming identifier is registered
// 重用section的footer,header
@available(iOS 6.0, *)
public func dequeueReusableHeaderFooterViewWithIdentifier(identifier: String) -> UITableViewHeaderFooterView? // like dequeueReusableCellWithIdentifier:, but for headers/footers

// Beginning in iOS 6, clients can register a nib or class for each cell.
// If all reuse identifiers are registered, use the newer -dequeueReusableCellWithIdentifier:forIndexPath: to guarantee that a cell instance is returned.
// Instances returned from the new dequeue method will also be properly sized when they are returned.
// 通过nib文件重用cell
@available(iOS 5.0, *)
public func registerNib(nib: UINib?, forCellReuseIdentifier identifier: String)
// 通过类通用cell
@available(iOS 6.0, *)
public func registerClass(cellClass: AnyClass?, forCellReuseIdentifier identifier: String)

// 重用section的footer,header
@available(iOS 6.0, *)
public func registerNib(nib: UINib?, forHeaderFooterViewReuseIdentifier identifier: String)
@available(iOS 6.0, *)
public func registerClass(aClass: AnyClass?, forHeaderFooterViewReuseIdentifier identifier: String)

// Focus
// 默认为false,是否自动记住最后一个获得焦点的indexPath
@available(iOS 9.0, *)
public var remembersLastFocusedIndexPath: Bool
}