共用方式為


Xamarin.iOS 中的表格元件和功能

UITableView 可以有「群組」或「純文字」樣式,且包含下列部分:

這些螢幕快照顯示區段數據列、頁首、頁尾、編輯控件和索引的顯示方式。

這些螢幕快照顯示區段數據列、頁首、頁尾、編輯控件和索引的顯示方式

以下更詳細地說明這些部分:

區段標頭

數據格可以選擇性地分組為區段、加上自定義頁首的標籤,以及/或以頁尾標示。 標頭可以使用字串值來設定,也可以提供自定義檢視,以允許不同的配置或樣式。

儲存格

單元格是數據表的主要使用者介面元素。 正確實作時,數據格會重新用於記憶體效率。 有四個內建的儲存格樣式,您可以在使用分鏡腳本時,在程式代碼中或設計工具中建立自己的自定義儲存格。

選擇性區段頁尾可以使用字串值來設定,也可以提供自定義檢視以允許不同的版面配置或樣式。 區段頁首和頁尾可以獨立設定。

索引

索引會顯示為數據表右邊緣的字元帶狀。 觸控或拖曳索引會加速捲動至數據表的該部分。 索引是選擇性的,但建議用來協助巡覽長清單。 索引通常不會與群組樣式搭配使用。

編輯模式

有幾種不同的編輯功能可供使用:

  • 撥動以刪除個別儲存格。
  • 進入編輯模式以顯示每個數據列上的刪除按鈕
  • 進入編輯模式以顯示重新排序句柄。
  • 插入新儲存格(具有動畫)。

本文件的其餘部分說明如何使用 Xamarin.iOS 實作所有這些 UITableView 功能。

類別概觀

用來顯示資料表檢視的主要類別如下所示:

這裡會顯示用來顯示數據表檢視的主要類別

每個類別的用途如下所述:

  • UITableView – 包含卷動容器內儲存格集合的檢視。 數據表檢視通常會在 i 電話 應用程式中使用整個螢幕,但可能存在於 iPad 上較大檢視的一部分(或出現在彈出視窗中)。
  • UITableViewCell – 代表數據表檢視中單一單元格(或數據列)的檢視。 有四種內建的儲存格類型,而且可以在 C# 或 iOS 設計工具中建立自定義儲存格。
  • UITableViewSource – Xamarin.iOS 專屬的抽象類,提供顯示數據表所需的所有方法,包括數據列計數、傳回每個數據列的儲存格檢視、處理數據列選取範圍和其他許多選擇性功能。 您必須將這個子類別化,才能讓UITableView運作。
  • NSIndexPath – 包含可唯一識別數據表中儲存格位置的 Row 和 Section 屬性。
  • UITableViewController – 現成可用的 UIViewController ,其 UITableView 硬式編碼為其檢視,並可透過 TableView 屬性存取。
  • UIViewController – 如果數據表未佔用整個畫面,您可以將 UITableView 新增至任何 UIViewController,並適當地設定其 Frame。

UITableViewSource 會取代下列兩個類別,這些類別仍可在 Xamarin.iOS 中使用,但通常不需要:

  • UITableViewDataSource – Objective-C Xamarin.iOS 中模型化為抽象類的通訊協定。 必須進行子類別化,才能為每個儲存格提供一個檢視表,以及有關表格中頁首、頁尾和列數和區段的資訊。
  • UITableViewDelegate – 模型 Objective-C 化為 Xamarin.iOS 類別的通訊協定。 處理選取、編輯功能和其他選擇性數據表功能。

在本檔中,範例全都使用UITableViewSource並忽略這兩個類別。 這裡會提及它們,因為 Apple 檔中找到的任何 Objective-C 範例都會參考它們,因此了解它們的功能很有用(而且您可以改用 Xamarin.iOS 的 UITableViewSource)。