这是用户在 2024-12-19 19:52 为 https://developer.apple.com/documentation/uikit/uitableviewdelegate 保存的双语快照页面，由 沉浸式翻译 提供双语支持。了解如何保存？
Skip Navigation
Protocol  协议

UITableViewDelegate  OUTableViewDelegate

Methods for managing selections, configuring section headers and footers, deleting and reordering cells, and performing other actions in a table view.
用于管理选择、配置节页眉和页脚、删除单元格和重新排序以及在表格视图中执行其他操作的方法。
@MainActor
protocol UITableViewDelegate : UIScrollViewDelegate

Overview  概述

Use the methods of this protocol to manage the following features:
使用此协议的方法管理以下功能：

  • Create and manage custom header and footer views.
    创建和管理自定义页眉和页脚视图。

  • Specify custom heights for rows, headers, and footers.
    指定行、页眉和页脚的自定义高度。

  • Provide height estimates for better scrolling support.
    提供高度估计以获得更好的滚动支持。

  • Indent row content.  缩进行内容。

  • Respond to row selections.
    响应行选择。

  • Respond to swipes and other actions in table rows.
    响应表行中的滑动和其他操作。

  • Support editing the table’s content.
    支持编辑表格的内容。

The table view specifies rows and sections using IndexPath. For information about how to interpret row and section indexes, see Specify the location of rows and sections.
表视图使用 IndexPath 指定行和区域。有关如何解释行索引和节索引的信息，请参阅指定行和节的位置。

Topics  主题

Configuring rows for the table view
为表视图配置行

func tableView(UITableView, willDisplay: UITableViewCell, forRowAt: IndexPath)  func tableView（UITableView，将显示：UITableViewCell，对于RowAt：索引路径）
Tells the delegate the table view is about to draw a cell for a particular row.
告诉代理表视图将要为特定行绘制单元格。
func tableView(UITableView, indentationLevelForRowAt: IndexPath) -> Int  func tableView（UITableView， indentationLevelForRowAt： IndexPath） -> Int
Asks the delegate to return the level of indentation for a row in a given section.
要求委托返回给定节中一行的缩进级别。

Required  必填

func tableView(UITableView, shouldSpringLoadRowAt: IndexPath, with: any UISpringLoadedInteractionContext) -> Bool  func tableView（UITableView，应SpringLoadRowAt： IndexPath，包含：任何 UISpring加载的交互上下文） -> Bool
Called to let you fine tune the spring-loading behavior of the rows in a table.
调用以允许您微调表中行的 spring-loading 行为。

Responding to row selections
响应行选择

Handling row selection in a table view
在表视图中处理行选择
Detect when a user taps a table view cell so your app can take the next indicated action.
检测用户何时点击表视图单元格，以便您的应用可以执行下一个指示的操作。
Selecting multiple items with a two-finger pan gesture
使用双指平移手势选择多个项目
Accelerate user selection of multiple items using the multiselect gesture on table and collection views.
在表视图和产品系列视图上使用多选手势加速用户选择多个项目。
func tableView(UITableView, willSelectRowAt: IndexPath) -> IndexPath?  func tableView（UITableView， willSelectrowat： IndexPath） -> IndexPath？
Tells the delegate a row is about to be selected.
告诉代理将要选择一行。
func tableView(UITableView, didSelectRowAt: IndexPath)  func tableView（UITableView， didSelectrowat： indexpath）
Tells the delegate a row is selected.
告诉代理已选择一行。

Required  必填

func tableView(UITableView, willDeselectRowAt: IndexPath) -> IndexPath?  func tableView（UITableView，将取消选择行位置：索引路径） -> 索引路径？
Tells the delegate that a specified row is about to be deselected.
告知代理即将取消选择指定的行。

Required  必填

func tableView(UITableView, didDeselectRowAt: IndexPath)  func tableView（UITable View，did DeselectRowAt： IndexPath）
Tells the delegate that the specified row is now deselected.
告知代理现在已取消选择指定的行。

Required  必填

func tableView(UITableView, shouldBeginMultipleSelectionInteractionAt: IndexPath) -> Bool  func tableView（UITableView， 应在索引路径处开始多选交互） -> Bool
Asks the delegate whether the user can use a two-finger pan gesture to select multiple items in a table view.
询问代理用户是否可以使用双指平移手势来选择表视图中的多个项目。

Required  必填

func tableView(UITableView, didBeginMultipleSelectionInteractionAt: IndexPath)  func tableView（UITableView，在索引路径处开始多选交互）
Tells the delegate when the user starts using a two-finger pan gesture to select multiple rows in a table view.
当用户开始使用双指平移手势在表视图中选择多行时，通知代理。
func tableViewDidEndMultipleSelectionInteraction(UITableView)  func table视图结束了多选交互 （UITableView）
Tells the delegate when the user stops using a two-finger pan gesture to select multiple rows in a table view.
当用户停止使用双指平移手势在表视图中选择多行时，通知代理。

Required  必填

func tableView(UITableView, viewForHeaderInSection: Int) -> UIView?  func tableView（UITableView， viewForHeaderInSection： Int） -> UIView？
Asks the delegate for a view to display in the header of the specified section of the table view.
要求代理在表视图的指定部分的标题中显示一个视图。
func tableView(UITableView, viewForFooterInSection: Int) -> UIView?  func tableView（UITableView， viewForFooterInSection： Int） -> UIView？
Asks the delegate for a view to display in the footer of the specified section of the table view.
要求代理在表视图的指定部分的页脚中显示一个视图。
func tableView(UITableView, willDisplayHeaderView: UIView, forSection: Int)  func tableView（UITableView，将显示HeaderView：UIView，对于Section：Int）
Tells the delegate that the table is about to display the header view for the specified section.
通知代理表将要显示指定节的标题视图。
func tableView(UITableView, willDisplayFooterView: UIView, forSection: Int)  func tableView（UITableView，将显示页脚视图：UIView，对于Section：Int）
Tells the delegate that the table is about to display the footer view for the specified section.
告知代理表将要显示指定部分的页脚视图。
func tableView(UITableView, heightForRowAt: IndexPath) -> CGFloat  func tableView（UITableView， heightForRowAt： IndexPath） -> CGFloat
Asks the delegate for the height to use for a row in a specified location.
要求代理提供用于指定位置中的行的高度。

Required  必填

func tableView(UITableView, heightForHeaderInSection: Int) -> CGFloat  func tableView（UITableView， heightForHeaderInSection： Int） -> CGFloat
Asks the delegate for the height to use for the header of a particular section.
要求代理提供用于特定节的页眉的高度。

Required  必填

func tableView(UITableView, heightForFooterInSection: Int) -> CGFloat  func tableView（UITableView， heightForFooterInSection： Int） -> CGFloat
Asks the delegate for the height to use for the footer of a particular section.
要求代理提供用于特定部分页脚的高度。
class let automaticDimension: CGFloat  类 let 自动Dimension： CGFloat
A constant representing the default value for a given dimension.
一个常量，表示给定维度的默认值。

Estimating heights for the table’s content
估计表格内容的高度

func tableView(UITableView, estimatedHeightForRowAt: IndexPath) -> CGFloat  func tableView（UITableView，估计的行高度：索引路径）-> CGFloat
Asks the delegate for the estimated height of a row in a specified location.
要求代理提供指定位置中一行的估计高度。

Required  必填

func tableView(UITableView, estimatedHeightForHeaderInSection: Int) -> CGFloat  func tableView（UITableView， estimatedHeightForHeaderInSection： Int） -> CGFloat
Asks the delegate for the estimated height of the header of a particular section.
要求代理提供特定节的页眉的估计高度。
func tableView(UITableView, estimatedHeightForFooterInSection: Int) -> CGFloat  func tableView（UITableView， estimatedHeightForFooterInSection： Int） -> CGFloat
Asks the delegate for the estimated height of the footer of a particular section.
要求代理提供特定节页脚的估计高度。

Managing accessory views  管理附件视图

func tableView(UITableView, accessoryButtonTappedForRowWith: IndexPath)  func tableView（UITableView，附件ButtonTappedForRowwith： IndexPath）
Tells the delegate that the user tapped the detail button for the specified row.
告知代理用户点按了指定行的详细信息按钮。

Managing context menus  管理上下文菜单

Adding context menus in your app
在应用程序中添加上下文菜单
Provide quick access to useful actions by adding context menus to your iOS app.
通过向 iOS 应用程序添加上下文菜单，提供对有用操作的快速访问。
func tableView(UITableView, contextMenuConfigurationForRowAt: IndexPath, point: CGPoint) -> UIContextMenuConfiguration?  func tableView（UITableView， contextMenuConfigurationForRowAt： IndexPath， point： CGPoint） -> UIContext菜单配置？
Returns a context menu configuration for the row at a point.
返回某一点处行的上下文菜单配置。

Required  必填

func tableView(UITableView, previewForDismissingContextMenuWithConfiguration: UIContextMenuConfiguration) -> UITargetedPreview?  func tableView（UITableView， preview用于使用配置关闭上下文菜单：UIContextMenuconfiguration） -> UITargetedpreview？
Returns the destination view when dismissing a context menu.
在关闭上下文菜单时返回目标视图。

Required  必填

func tableView(UITableView, previewForHighlightingContextMenuWithConfiguration: UIContextMenuConfiguration) -> UITargetedPreview?  func tableView（UITableView， preview用于使用配置突出显示上下文菜单：UIContextMenuconfiguration） -> UITargetedpreview？
Returns a view to override the default preview the table view created.
返回一个视图以覆盖表视图创建的默认预览。
func tableView(UITableView, willDisplayContextMenu: UIContextMenuConfiguration, animator: (any UIContextMenuInteractionAnimating)?)  func tableView（UITableView，将显示上下文菜单：UIContext菜单配置，动画师：（任何 UIContext菜单交互动画）？）
Informs the delegate when a context menu will appear.
通知代理何时显示上下文菜单。
func tableView(UITableView, willEndContextMenuInteraction: UIContextMenuConfiguration, animator: (any UIContextMenuInteractionAnimating)?)  func tableView（UITableView，将结束上下文菜单交互：UIContext菜单配置，动画师：（任何 UIContext菜单交互动画）？）
Informs the delegate when a context menu will disappear.
通知代理上下文菜单何时消失。
func tableView(UITableView, willPerformPreviewActionForMenuWith: UIContextMenuConfiguration, animator: any UIContextMenuInteractionCommitAnimating)  func tableView（UITableView，将执行菜单预览操作：UIContext菜单配置，动画师：任何 UIContext菜单交互提交动画）
Informs the delegate when a user triggers a commit by tapping the preview.
当用户通过点按预览触发提交时通知代理。

Responding to row actions
响应行操作

func tableView(UITableView, leadingSwipeActionsConfigurationForRowAt: IndexPath) -> UISwipeActionsConfiguration?  func tableView（UITableView， leadingSwipeActionsConfigurationForRowAt： IndexPath） -> UISwipeActions配置？
Returns the swipe actions to display on the leading edge of the row.
返回要在行的前边缘显示的轻扫操作。

Required  必填

func tableView(UITableView, trailingSwipeActionsConfigurationForRowAt: IndexPath) -> UISwipeActionsConfiguration?  func tableView（UITableView， trailingSwipeActionsConfigurationForRowAt： IndexPath） -> UISwipeActions配置？
Returns the swipe actions to display on the trailing edge of the row.
返回要在行的尾随边缘上显示的滑动操作。
func tableView(UITableView, shouldShowMenuForRowAt: IndexPath) -> Bool  func tableView（UITableView， shouldShowMenuForRowAt： IndexPath） -> Bool
Asks the delegate if the editing menu should be shown for a certain row.
询问代理是否应为特定行显示编辑菜单。

Required  必填

Deprecated  荒废的
func tableView(UITableView, canPerformAction: Selector, forRowAt: IndexPath, withSender: Any?) -> Bool  func tableView（UITableView， canPerformAction： Selector， forRowAt： IndexPath， withSender： Any？） -> 布尔值
Asks the delegate if the editing menu should omit the Copy or Paste command for a given row.
询问代理编辑菜单是否应省略给定行的 Copy 或 Paste 命令。

Required  必填

Deprecated  荒废的
func tableView(UITableView, performAction: Selector, forRowAt: IndexPath, withSender: Any?)  func tableView （UITableView， performAction： Selector， forRowAt： IndexPath， withSender： Any？）
Tells the delegate to perform a copy or paste operation on the content of a given row.
通知代理对给定行的内容执行复制或粘贴操作。
Deprecated  荒废的
func tableView(UITableView, editActionsForRowAt: IndexPath) -> [UITableViewRowAction]?  func tableView（UITableView， editActionsForRowAt： IndexPath） -> [UITableViewRowAction]？
Asks the delegate for the actions to display in response to a swipe in the specified row.
要求代理提供为响应指定行中的滑动而显示的操作。

Required  必填

Deprecated  荒废的

Managing table view highlights
管理表视图突出显示

func tableView(UITableView, shouldHighlightRowAt: IndexPath) -> Bool  func tableView（UITableView， shouldHighlightRowAt： IndexPath） -> Bool
Asks the delegate if the specified row should be highlighted.
询问代理是否应突出显示指定的行。
func tableView(UITableView, didHighlightRowAt: IndexPath)  func tableView（UITableView， didHighlightRowAt： IndexPath）
Tells the delegate that the specified row was highlighted.
告知代理指定的行已突出显示。

Required  必填

func tableView(UITableView, didUnhighlightRowAt: IndexPath)  func tableView （UITableView， didUnhighlight Row At： Index Path） （ 未突出显示行 （在：索引路径）
Tells the delegate that the highlight was removed from the row at the specified index path.
告知委托已从指定索引路径处的行中删除突出显示。

Editing table rows  编辑表格行

func tableView(UITableView, willBeginEditingRowAt: IndexPath)  func tableView（UITableView，将在以下位置开始编辑行：索引路径）
Tells the delegate that the table view is about to go into editing mode.
通知代理表视图即将进入编辑模式。
func tableView(UITableView, didEndEditingRowAt: IndexPath?)  func tableView（UITableView， didEndEditingRowat： IndexPath？）
Tells the delegate that the table view has left editing mode.
告知代理表视图已退出编辑模式。
func tableView(UITableView, editingStyleForRowAt: IndexPath) -> UITableViewCell.EditingStyle  func tableView（UITableView， editingStyleForRowAt： IndexPath） -> UITableView单元格。编辑样式
Asks the delegate for the editing style of a row at a particular location in a table view.
要求代理提供表视图中特定位置的行的编辑样式。

Required  必填

func tableView(UITableView, titleForDeleteConfirmationButtonForRowAt: IndexPath) -> String?  func tableView（UITableView， titleForDeleteConfirmationButtonForRowAt： IndexPath） -> 字符串？
Changes the default title of the delete-confirmation button.
更改删除确认按钮的默认标题。

Required  必填

func tableView(UITableView, shouldIndentWhileEditingRowAt: IndexPath) -> Bool  func tableView（UITableView，应在编辑行时缩进：索引路径） -> bool
Asks the delegate whether the background of the specified row should be indented while the table view is in editing mode.
询问代理在表视图处于编辑模式时是否应缩进指定行的背景。

Required  必填

Reordering table rows  对表行重新排序

func tableView(UITableView, targetIndexPathForMoveFromRowAt: IndexPath, toProposedIndexPath: IndexPath) -> IndexPath  func tableView（UITable视图，目标索引路径用于从行位置移动到建议的索引路径 ：索引路径） -> 索引路径
Asks the delegate to return a new index path to retarget a proposed move of a row.
要求委托返回新的索引路径，以重新定位建议的行移动。

Tracking the removal of views
跟踪视图的移除

func tableView(UITableView, didEndDisplaying: UITableViewCell, forRowAt: IndexPath)  func tableView（UITableView， didEndDisplaying： UITableViewcell， forrowat： indexpath）
Tells the delegate that the specified cell was removed from the table.
告知代理已从表中删除指定的单元格。

Required  必填

func tableView(UITableView, didEndDisplayingHeaderView: UIView, forSection: Int)  func tableView（UITableView， didEndDisplayingHeaderView： UIView， forsection： int）
Tells the delegate that the specified header view was removed from the table.
告知代理已从表中删除指定的标题视图。
func tableView(UITableView, didEndDisplayingFooterView: UIView, forSection: Int)  func tableView（UITableView， didEndDisplayingFooterView： UIView， forsection： int）
Tells the delegate that the specified footer view was removed from the table.
告知代理已从表格中删除指定的页脚视图。

Required  必填

Managing table view focus
管理表视图焦点

func tableView(UITableView, canFocusRowAt: IndexPath) -> Bool  func tableView（UITableView， canFocusRowat： IndexPath） -> 布尔值
Asks the delegate whether the cell at the specified index path is itself focusable.
询问代理指定索引路径处的单元格本身是否可聚焦。

Required  必填

func tableView(UITableView, shouldUpdateFocusIn: UITableViewFocusUpdateContext) -> Bool  func tableView（UITableView， shouldUpdateFocusin： UITableView焦点更新上下文） -> Bool
Asks the delegate whether the focus update specified by the context is allowed to occur.
询问代理是否允许进行上下文指定的焦点更新。

Required  必填

func tableView(UITableView, didUpdateFocusIn: UITableViewFocusUpdateContext, with: UIFocusAnimationCoordinator)  func tableView（UITable View，did UpdateFocusIn： UITableViewFocusUpdateContext，与：UIFocusAnimationCoordinator）
Tells the delegate that a focus update specified by the context has just occurred.
告知委托上下文指定的焦点更新刚刚发生。
func indexPathForPreferredFocusedView(in: UITableView) -> IndexPath?  首选焦点视图的 func 索引路径（in： UITable View） -> 索引路径？
Asks the delegate for the table view’s index path for the preferred focused view.
向委托人询问首选焦点视图的表视图的索引路径。

Required  必填

func tableView(UITableView, selectionFollowsFocusForRowAt: IndexPath) -> Bool  func tableView（UITableView， selectionFollowsFocusForRowAt： IndexPath） -> Bool
Asks the delegate whether to relate selection and focus behavior for the row at the corresponding index path.
询问委托是否将相应索引路径处行的选择和焦点行为关联起来。

Required  必填

Performing primary actions
执行主要操作

func tableView(UITableView, canPerformPrimaryActionForRowAt: IndexPath) -> Bool  func tableView（UITableView， canPerformPrimaryActionForRowat： IndexPath） -> Bool
Asks the delegate whether to perform a primary action for the row at the specified index path.
询问委托是否对指定索引路径处的行执行主操作。
func tableView(UITableView, performPrimaryActionForRowAt: IndexPath)  func tableView（UITableView，在 Index Path： 对行执行主要操作）
Tells the delegate to perform the primary action for the row at the specified index path.
通知委托对指定索引路径处的行执行主要操作。

Required  必填

Relationships  关系

Inherits From  继承自

Conforming Types  符合类型

See Also  另请参阅

Table management  表管理

Estimating the height of a table’s scrolling area
估计表格滚动区域的高度
Provide height estimates for your table view’s headers, footers, and rows to ensure that scrolling accurately reflects the size of your content.
为表格视图的页眉、页脚和行提供高度估计值，以确保滚动准确反映内容的大小。
class UITableViewController  类 UITable视图控制器
A view controller that specializes in managing a table view.
一个专门用于管理表视图的视图控制器。
class UITableViewFocusUpdateContext  class UITableView焦点更新上下文
A context object that provides information relevant to a specific focus update from one view to another.
一个上下文对象，它提供与从一个视图到另一个视图的特定焦点更新相关的信息。
Current page is UITableViewDelegate