在MonoTouch中自定义表格

完整例子的源代码可以在这里下载。

为什么要定制表格?

表格在很多iPhone应用程序中都是必需的UI元素。虽然对于应用程序开发而言,这并非是一项新发明,鉴于设备尺寸等方面的限制,表格在iPhone中的功能是非常固定的。

苹果在其SDK中,直接内置了很多风格来让你定制表格。不过,在你最初创建表格的时候,它看起来非常简单。在没有进行任何定制的时候,你可以为表格选择两种基本风格,默认风格和分组风格:

在MonoTouch中自定义表格_第1张图片

在对表格中的单元格进行一点调整后,你就可以添加图标和说明文字:

在MonoTouch中自定义表格_第2张图片

你甚至能改变单元格的字体和颜色,然而,有时候这样还是不足够。如果你真的想完全改变基本的风格,创建一个复杂的UI,那么你必须创建自己的自定义单元格控件。下面的截图是定制后的效果,这个应用程序使用完全定制的单元格来显示内容:

在MonoTouch中自定义表格_第3张图片

幸好,苹果让我们有便捷的方法来完成这样的定制,就是允许我们创建自己的定制UITableViewCell 控件,并把其用于UITableView 控件中。下面,让我们来逐步创建一个应用程序,学习如何利用UITableViewUITableViewCell 控件来创建上图所示效果的例子。

示例应用程序

那么接下来,我们就来创建应用程序。首先,打开MonoDevelop,如下图所示:

在MonoTouch中自定义表格_第4张图片

接着,新建一个iPhone MonoTouch项目。从“File”菜单中,选择“New Soluton”:

在MonoTouch中自定义表格_第5张图片

从C# iPhone 模板中选择“iPhone Window-based Project”,输入解决方案的名称“Example_CustomUITableViewCells”:

在MonoTouch中自定义表格_第6张图片

在项目特性对话框上点击“OK”,这些内容和我们要做的应用程序无关:

在MonoTouch中自定义表格_第7张图片

我们的项目现在创建好了,如下图所示:

在MonoTouch中自定义表格_第8张图片

通过在Solution Explorer窗口里双击MainWindow.xib,以便在Interface Builder中打开它,之后你会看到如下内容:

在MonoTouch中自定义表格_第9张图片

我们首先拖一个UITableView控件到我们的MainWindow中,效果如下:

在MonoTouch中自定义表格_第10张图片

我们需要在AppDelegate类中添加一个outlet,以便我们能编程访问这个Table View。

在Library窗口中,选择顶部的“Classes”标签页,接着在下拉列表中选择“Other Classes”。确保AppDelegate已经选中,在Library窗口的下半部点击“Outlets”标签页:

在MonoTouch中自定义表格_第11张图片

让我们来创建一个名为“tblMain”的outlet,通过点击“+”按钮,在名称列输入“tblMain”,你的outlet应该类似下图的:

在MonoTouch中自定义表格_第12张图片

接着,把outlet关联到我们之前添加的UITableView上。在Document窗口中选择AppDelegate,在Connections Inspector窗口中,就会看到新创建的tblMain  outlet:

在MonoTouch中自定义表格_第13张图片

从连接管理器中把右侧的outlet的圆点拖动到Document窗口或Window Designer的表格上,就可以把它们关联到一起:

在MonoTouch中自定义表格_第14张图片

现在,我们得到了一个关联过的表格,让我们回到MonoDevelop,编写一些代码。

在项目上按右键,在上下文菜单中选择“Add”,接着选择“New Folder”,把文件夹命名为“Code“。

接着创建一个命名为“BasicTableViewItem.cs”的类。即,在项目上再次按右键,在上下文菜单中选择“Add”,接着选择“New File”。命名类,并点击“New”:

在MonoTouch中自定义表格_第15张图片

在这个代码文件中,输入如下代码:

namespace Example_CustomUITableViewCells
{
	//========================================================================
	/// <summary>
	/// Represents our item in the table
	/// </summary>

	public class BasicTableViewItem
	{
		public string Name { get; set; }
		
		public string SubHeading { get; set; }
		
		public string ImageName { get; set; }

		public BasicTableViewItem ()
		{
		}
	}
	//========================================================================

}

这个类相当简单,它表示了一个在单元格中的项目,并具有如下属性:

  • Name ——这个项目所显示的文本
  • SubHeading ——显示在项目名称下面的文本
  • ImageName ——这个项目所显示的图片名称

我们将在后面会看到如何使用这个类。

接着,在“Code”文件夹中,创建另外一个类,命名为“BasicTableViewItemGroup”,并输入如下代码:

using System;
using System.Collections.Generic;

namespace Example_CustomUITableViewCells
{
	//========================================================================
	/// <summary>

	/// A group that contains table items
	/// </summary>
	public class BasicTableViewItemGroup

	{
		public string Name { get; set; }

		public string Footer { get; set; }
		
		public List<BasicTableViewItem> Items
		{
			get { return this._items; }
			set { this._items = value; }
		}
		protected List<BasicTableViewItem> _items = new List<BasicTableViewItem>();
		
		public BasicTableViewItemGroup ()
		{
		}
	}
	//========================================================================

}

这也是一个相当简单的类。它用于项目分组的容器。具有如下属性:

  • Name ——分组的名称。通常显示在分组的顶部。
  • Footer ——显示在当前组中所有项目的底部文字
  • Items ——分组所包含的BasicTableViewItem的List<>集合。我们在其构造的时候实例化这个集合,以便在添加项目的时候无需手动去实例化它。

接着,再在同一个文件夹中创建另外一个类,命名为“BasicTableViewSource”,并输入如下代码:

using System;
using System.Collections.Generic;
using MonoTouch.UIKit;

namespace Example_CustomUITableViewCells
{
	//========================================================================
	/// <summary>

	/// Combined DataSource and Delegate for our UITableView
	/// </summary>
	public class BasicTableViewSource : UITableViewSource

	{
		//---- declare vars
		protected List<BasicTableViewItemGroup> _tableItems;
		string _cellIdentifier = "BasicTableViewCell";
		
		public BasicTableViewSource (List<BasicTableViewItemGroup> items)
		{
			this._tableItems = items;
		}
		
		/// <summary>

		/// Called by the TableView to determine how many sections(groups) there are.
		/// </summary>
		public override int NumberOfSections (UITableView tableView)
		{
			return this._tableItems.Count;
		}

		/// <summary>

		/// Called by the TableView to determine how many cells to create for that particular section.
		/// </summary>
		public override int RowsInSection (UITableView tableview, int section)
		{
			return this._tableItems[section].Items.Count;
		}

		/// <summary>

		/// Called by the TableView to retrieve the header text for the particular section(group)
		/// </summary>
		public override string TitleForHeader (UITableView tableView, int section)
		{
			return this._tableItems[section].Name;
		}

		/// <summary>

		/// Called by the TableView to retrieve the footer text for the particular section(group)
		/// </summary>
		public override string TitleForFooter (UITableView tableView, int section)
		{
			return this._tableItems[section].Footer;
		}

		/// <summary>

		/// Called by the TableView to get the actual UITableViewCell to render for the particular section and row
		/// </summary>
		public override UITableViewCell GetCell (UITableView tableView, MonoTouch.FoundationNSIndexPath indexPath)
		{
			//---- declare vars

			UITableViewCell cell = tableView.DequeueReusableCell (this._cellIdentifier);
			
			//---- if there are no cells to reuse, create a new one
			if (cell == null)
			{
				cell = new UITableViewCell (UITableViewCellStyle.Default, this._cellIdentifier);
			}
		
			//---- create a shortcut to our item

			BasicTableViewItem item = this._tableItems[indexPath.Section].Items[indexPath.Row];
			
			cell.TextLabel.Text = item.Name;

			return cell;
		}
	}
	//========================================================================

}

UITableViewSource 类负责处理我们数据的绑定,也处理用户和表格的交互。在我们的例子中,处理用户交互超出本篇文章的范围,不过我们依然需要完成数据绑定的功能。

这个类比其他两个稍微有点复杂,它的成员逐一说明如下:

  • 变量声明——我们声明了两个变量,_tableItems,用于获取表格对象的本地变量,_cellIdentifier,在后面在重用表格单元格的时候提供一个关键字。
  • 构造器——构造器接受一个名为items 的参数,其类型是List<BasicTableViewItemGroup>。在我们的例子中,我们强制类和项目分组一起实例化,以便我们确信他们都是有效的。
  • NumberOfSections ——这个方法用于获取在表格中创建的分组数目。在我们的例子中,就返回_tableItems的分组数目。
  • RowsInSection ——这个方法用于获取表格中特定分组的项目数目。根据特定的分组索引,返回其包含项目的数量。
  • TitleForHeader ——这个方法返回某个分组标头的文本。就是返回当前分组对象BasicTableViewItemGroupName 属性。
  • TitleForFooter ——这个方法返回某个分组标脚的文本。类似TitleForHeader,不过这次是返回Footer属性。
  • GetCell ——这个方法根据特定分组和行返回实际的UITableCell 控件,这也是数据绑定大量工作发生的地方。首先,我们在相关的UITableView上调用DequeueReusableCell 。这样做主要是因为性能原因。因为iPhone限制了处理器的耗能,如果每次显示都必须创建新的UITableViewCell 的话,在遇到很长列表的时候可能会变得非常慢。为了解决这个问题,UITableView 控件中后台维护着一个UITableViewCell 控件缓存池,在单元格滚动出可视范围的时候,它会放入到这个缓存池中以备重用。这也就是_cellIdentifier变量的用武之处。

好,现在我们编写好了相关的类,就要开始添加一些图片,以便可以在项目上显示图标。

首先,在项目中类似之前创建“Code”文件夹那样,创建一个名为“Images”的文件夹。把如下的图片按照对应的名称逐一保存到你的硬盘上:

图片

名称

PawIcon.png

LightBulbIcon.png

PushPinIcon.png

TargetIcon.png

 

一旦保存好,就要把他们添加到项目中。在“Images”文件夹上点右键,选择“Add Files”。选择你保存好的图片,勾中“Override default build action”,在下拉列表中选择“Content”。这很重要。Content是让你在运行时可以加载并使用它们的唯一构建动作。

你的解决方案现在应该如下所示:

在MonoTouch中自定义表格_第16张图片

为了确保你之前的步骤都是正确的,可以通过编译项目来检验。要进行编译,按住Apple Key(苹果键),再按“B”键,或者从“Build”菜单中选择”Build All“。

一切正常的话,我们就准备好了相关的类和图片。让我们来编辑应用程序代码以使用它们!

在Main.cs上双击,显示出代码编辑器。在AppDelegate类中,添加如下代码行:

BasicTableViewSource _tableViewSource; 

This is a class variable to hold our BasicTableViewSource that we created earlier.

这是一个类变量,用来保存我们早期创建的BasicTableViewSource 实例。

接着,把如下方法复制到AppDelegate类中:

/// <summary>
/// Creates a set of table items.
/// </summary>
protected void CreateTableItems ()
{
	List<BasicTableViewItemGroup> tableItems = new List<BasicTableViewItemGroup> ();
	
	//---- declare vars

	BasicTableViewItemGroup tGroup;
	
	//---- birds
	tGroup = new BasicTableViewItemGroup() { Name = "Birds", Footer = "Birds have wings, and sometimes use them." };
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Crow", SubHeading = "AKA, Raven.", ImageName = "PawIcon.png" });
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Chicken", SubHeading = "Males are called roosters.", ImageName = "PushPinIcon.png" });
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Turkey", SubHeading = "Eaten at thanksgiving.", ImageName = "LightBulbIcon.png" });
	tableItems.Add (tGroup);

	//---- fish

	tGroup = new BasicTableViewItemGroup() { Name = "Fish", Footer = "Fish live in water. Mostly." };
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Trout", SubHeading = "Rainbow is a popular kind.", ImageName = "TargetIcon.png" });
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Salmon", SubHeading = "Good sushi.", ImageName = "PawIcon.png" });
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Cod", SubHeading = "Flat fish.", ImageName = "LightBulbIcon.png" });
	tableItems.Add (tGroup);

	//---- mammals

	tGroup = new BasicTableViewItemGroup() { Name = "Mammals", Footer = "Mammals nurse their young." };
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Deer", SubHeading = "Bambi.", ImageName = "PushPinIcon.png" });
	tGroup.Items.Add (new BasicTableViewItem() { Name = "Bats", SubHeading = "Fly at night.", ImageName = "TargetIcon.png" });
	tableItems.Add (tGroup);
	
	this._tableViewSource = new BasicTableViewSource(tableItems);
}

我们将调用这个方法来创建数据源,完成在表格中显示数据的过程。

最终,在AppDelegate 类中的FinishedLaunching 方法中,在调用window.MakeKeyAndVisible 之前加入如下代码。

this.CreateTableItems (); 
this.tblMain.Source = this._tableViewSource; 

通过调用这个方法,我们就创建了一个表格数据源,并把数据源赋值给表格。

最终的Main.cs应该像这样:

using System;
using System.Collections.Generic;
using System.Linq;
using MonoTouch.Foundation;
using MonoTouch.UIKit;

namespace Example_CustomUITableViewCells
{
	public class Application

	{
		static void Main (string[] args)
		{
			UIApplication.Main (args);
		}
	}

	// The name AppDelegate is referenced in the MainWindow.xib file.
	public partial class AppDelegate : UIApplicationDelegate

	{
		BasicTableViewSource _tableViewSource;
		
		// This method is invoked when the application has loaded its UI and its ready to run
		public override bool FinishedLaunching (UIApplication app, NSDictionary options)
		{
			this.CreateTableItems ();
			this.tblMain.Source = this._tableViewSource;
	
			// If you have defined a view, add it here:

			// window.AddSubview (navigationController.View);
			window.MakeKeyAndVisible ();
			
			return true;
		}

		// This method is required in iPhoneOS 3.0
		public override void OnActivated (UIApplication application)
		{
		}
		
		/// <summary>

		/// Creates a set of table items.
		/// </summary>
		protected void CreateTableItems ()
		{
			List<BasicTableViewItemGroup> tableItems = new List<BasicTableViewItemGroup> ();
			
			//---- declare vars

			BasicTableViewItemGroup tGroup;
			
			//---- birds
			tGroup = new BasicTableViewItemGroup() { Name = "Birds", Footer = "Birds have wings, and sometimes use them." };
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Crow", SubHeading = "AKA, Raven.", ImageName = "PawIcon.png" });
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Chicken", SubHeading = "Males are called roosters.", ImageName = "PushPinIcon.png" });
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Turkey", SubHeading = "Eaten at thanksgiving.", ImageName = "LightBulbIcon.png" });
			tableItems.Add (tGroup);
		
			//---- fish

			tGroup = new BasicTableViewItemGroup() { Name = "Fish", Footer = "Fish live in water. Mostly." };
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Trout", SubHeading = "Rainbow is a popular kind.", ImageName = "TargetIcon.png" });
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Salmon", SubHeading = "Good sushi.", ImageName = "PawIcon.png" });
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Cod", SubHeading = "Flat fish.", ImageName = "LightBulbIcon.png" });
			tableItems.Add (tGroup);
		
			//---- mammals

			tGroup = new BasicTableViewItemGroup() { Name = "Mammals", Footer = "Mammals nurse their young." };
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Deer", SubHeading = "Bambi.", ImageName = "PushPinIcon.png" });
			tGroup.Items.Add (new BasicTableViewItem() { Name = "Bats", SubHeading = "Fly at night.", ImageName = "TargetIcon.png" });
			tableItems.Add (tGroup);
			
			this._tableViewSource = new BasicTableViewSource(tableItems);
		}
	
	}
}

让我们来运行下应用程序,看看什么样子。要运行应用程序,按住苹果键,并按”Enter”按钮,或者从Run菜单中选择Debug。

当我们运行它之后,就可以看到下图所示效果:

在MonoTouch中自定义表格_第17张图片

脚标看上去稍显怪异。让我们来把表格的类型改为Grouped 后重新运行一下。要这样做,需要在Interface Builder中打开MainWindow.xib ,然后在Document窗口上点击Table View来编辑表格风格,接着在Inspector窗口,通过风格下拉列表来改变为“Grouped”:

在MonoTouch中自定义表格_第18张图片

保存文件,切换回MonoDevelop,再次运行应用程序,你就可以看到如下效果了:

在MonoTouch中自定义表格_第19张图片

现在脚标就看着顺眼多了。

让我们再来处理其他地方。在项目中要显示一些图片和子标题,那么下面就要着手编写。

停止应用程序,接着双击BasicTableViewSource.cs 类来编辑它。在GetCell method方法中把如下代码行:

cell = new UITableViewCell (UITableViewCellStyle.Default, this._cellIdentifier); 

改为:

cell = new UITableViewCell (UITableViewCellStyle.Subtitle, this._cellIdentifier); 

这样就把UITableViewCell 的风格改变为Subtitle ,其会在单元格中显示文本的第二行。

你能选用的只有很少的风格。然而要注意,只有在DefaultSubtitle 风格中才支持图片。

现在,在这行之后:

cell.TextLabel.Text = item.Name; 

增加:

cell.Accessory = UITableViewCellAccessory.Checkmark;
cell.DetailTextLabel.Text = item.SubHeading;
if(!string.IsNullOrEmpty(item.ImageName))
{
	cell.ImageView.Image = UIImage.FromFile("Images/" + item.ImageName );
}

UITableViewCells 的原来样子就会被改变为如下所示:

在MonoTouch中自定义表格_第20张图片

UITableViewCell 控件原本带有两个主要部分,单元格主体区,其是单元格显示内容的全部区域;单元格内容区,其通常用来放置内容在里面。如果附加区未使用的话,单元格内容区就会扩展占满整个单元格主体区。类似地,如果图片区不使用的话,标签区会覆盖图片的地方。

让我们来看 一下如何在代码中使用这些区域。第一行代码告诉单元格,右边会有一个Checkmark 。接着我们添加SubHeading 文本到DetailTextLabel 上。最后,我们在单元格上设置一个图片。

很容易就可以通过文件来创建图片对象。简单地使用UIImage.FromFile构造函数,把图片文件的路径传递就去。由于之前把图片文件的编译类型设为Content ,只要项目中的文件夹结构就是文件系统的,那么就可以容易地访问它们。

现在运行应用程序,就得到下面的效果:

在MonoTouch中自定义表格_第21张图片

非常好。如果在Interface Builder 中把表格风格改回Plain(双击打开MainWindow.xib ,选择表格,在下拉列表中选择风格为“Plain”,并保存),那么再次运行,就得到:

在MonoTouch中自定义表格_第22张图片

还是很漂亮的。

在iPhone OS 3.0之后,我们也能定义一些其他属性,包括TextColor、SelectedTextColor、SelectedImage、BackgroundView、SelectedBackgroundView等等。这虽然让你有了更多的个性化设置,不过有时候,我们需要完全不同的显示效果。

要完成这个工作,必须创建自己的表格单元格。苹果允许我们通过继承UITableViewCell ,并创建其中我们所想的任何内容。

那么,让我们来创建自定义的表格样式。首先,在项目中创建一个名为“Controls”的新文件夹。在其中,我们打算用View Controller来创建新视图。在Controls文件夹上点右键,选择“Add”,接着“New File”,从左栏选择“iPhone”并在右边选择“View Interface Definition with Controller”,并命名为“CustomTableViewCell”:

在MonoTouch中自定义表格_第23张图片

在Interface Builder打开CustomTableViewCell.xib 。就会显示空白视图:

在MonoTouch中自定义表格_第24张图片

我们不想使用标准视图,而要创建一个UITableViewCell,所以我们会删除这个视图并用一个单元格对象来替换它。

按住苹果键(Apple),按退格键,或者从编辑窗口中选择“Delete”就可以从Document窗口中删除这个视图。

接着,从Library窗口中拖一个Table View Cell到你的Document窗口中:

在MonoTouch中自定义表格_第25张图片

如果你在新添加到表格单元格上双击,就会打开设计器,你会看到一个设计界面来让你添加控件:

那么,现在让我们来使用Interface Builder来设计自定义单元格。拖动右下角的让单元格变高点。接着,从Library窗口,拖一个UIImageView 控件和几个UILabels控件:

在MonoTouch中自定义表格_第26张图片

你可以使用Attributes Inspector 窗口来改变UILabel 控件的大小,以及颜色等等属性。不用看上去完全和上图一样,只需相关的元素都在对应位置就行。

现在,我们完成了自定义的设计,就来为自定义单元格添加outlet,和File’s Owner的内容,以便我们能访问它们。之前,我们把outlet直接添加到AppDelegate中,不过这里,要把他们添加到File’s Owner中,以便可以在所具有的视图上创建类。

在Document窗口中选择“File’s Owner”,接着在Library窗口中在顶部选择“Classes”,在下拉列表中选择“Other Classes”。选择我们的CustomTableViewCell 类,接着在窗口的下半部选择“Outlets”标签页。添加名为“cellMain”、“lblHeading”、“lblSubHeading”和“imgMain:”的Outlets:

在MonoTouch中自定义表格_第27张图片

把Outlets和我们之前添加的控件关联起来,就像对表格控件所做的那样。

确保Document窗口的“File’s Owner“是被选中的,从Connection Inspector中把圆点拖到Document窗口的控件上:

在MonoTouch中自定义表格_第28张图片

最后一件我们必须在Interface Builder中完成的事情,就是提供一个单元格标识。在Document窗口上点击”Table View Cell“,接着在Attributes Inspector上把Identifier 属性设置为”MyCustomTableCellView“:

这让我们的自定义单元格模板可以被重用,正如之前我们在代码中实现的那样。

我们已经完成了Interface Builder中事情了,那么保存文件,返回到MonoDevelop中。双击CustomTableCellView.xib.cs 打开这个类文件。

我们要对这个类进行一点编辑。首先,我们来添加一些属性到类里面:

public UITableViewCell Cell
{
	get { return this.cellMain; }
}

public string Heading
{
	get { return this.lblHeading.Text; }
	set { this.lblHeading.Text = value; }
}


public string SubHeading
{
	get { return this.lblSubHeading.Text; }
	set { this.lblSubHeading.Text = value; }
}


public UIImage Image
{
	get { return this.imgMain.Image; }
	set { this.imgMain.Image = value; }
}

我们来看一下这些属性:

  • Cell – 这个属性让这个自定义单元格的调用者可以直接访问单元格本身,以便在UITableViewSourceGetCell 调用中,我们能直接从一个属性简单地返回,过一会我们会看到怎么弄。
  • Heading 和SubHeading – 这个属性暴露了可以直接访问表格单元格中UILabel 控件的文本值。
  • Image – 这个属性直接暴露表格单元格中的UIImage 控件。

接下来,我们需要编辑其中一个构造器。文件在被MonoDevelop创建好后,文件中的最后一个构造器看起来如下:

public CustomTableViewCell () : base("CustomTableViewCell", null)
{
	Initialize ();
}

这是一个非常简单的构造器,如果你读过Mono文档关于基类构造说明的话,就会明白这里它会初始化这个类,并用我们传递进去的名称来加载Nib(编译好的.xib文件)文件。然而,文档中没有提到的是,基类构造器是异步的。如果你使用这种方式来调用,那么Nib好像未被立刻加载,在我们给自定义单元格设置诸如Heading属性的时候,我们会得到讨厌的空引用错误。

为了修正这个问题,我们必须确保Nib文件同步地加载,即直到加载完成,方法是不会返回。

那么,就需要编辑构造器,以便看起来如下:

public CustomTableViewCell ()// : base("CustomTableViewCell", null)
{
	//---- this next line forces the loading of the xib file to be synchronous
	MonoTouch.Foundation.NSBundle.MainBundle.LoadNib ("CustomTableViewCell", this, null);
	Initialize ();
}

在这里,我们首先要做到就是,把调用基类构造器的代码注释掉。我们会手动地进行来调用那个代码,所以在这里不用再调一次。接下来,我们添加一个对LoadNib方法的调用。它实际上和基类构造器所做的事情是一样的,除了不会强制进行异步处理。现在,我们确保了Nib以及任何东西都能初始化,以便我们能访问它。

完整的类看上去如下所示:

using System;
using MonoTouch.Foundation;
using MonoTouch.UIKit;
using System;

namespace Example_CustomUITableViewCells
{
	//========================================================================

	public partial class CustomTableViewCell : UIViewController
	{
		#region Constructors

		// The IntPtr and initWithCoder constructors are required for controllers that need 

		// to be able to be created from a xib rather than from managed code

		public CustomTableViewCell (IntPtr handle) : base(handle)
		{
			Initialize ();
		}

		[Export("initWithCoder:")]
		public CustomTableViewCell (NSCoder coder) : base(coder)
		{
			Initialize ();
		}

		public CustomTableViewCell ()// : base("CustomTableViewCell", null)

		{
			//---- this next line forces the loading of the xib file to be synchronous
			MonoTouch.Foundation.NSBundle.MainBundle.LoadNib ("CustomTableViewCell", this, null);
			Initialize ();
		}

		void Initialize ()
		{
		}
		
		#endregion

		
		
		public UITableViewCell Cell
		{
			get { return this.cellMain; }
		}
		
		public string Heading
		{
			get { return this.lblHeading.Text; }
			set { this.lblHeading.Text = value; }
		}
		
		public string SubHeading
		{
			get { return this.lblSubHeading.Text; }
			set { this.lblSubHeading.Text = value; }
		}
		
		public UIImage Image
		{
			get { return this.imgMain.Image; }
			set { this.imgMain.Image = value; }
		}
		
	}
	//========================================================================

}

好,现在构建好自定义单元格类了,接着往下走,来创建自定义UITableViewSource 类。

在”Code“文件夹中,创建一个新的类,复制如下代码进去:

using System;
using System.Collections.Generic;
using MonoTouch.UIKit;

namespace Example_CustomUITableViewCells
{
	//========================================================================
	/// <summary>

	/// Combined DataSource and Delegate for our UITableView with custom cells
	/// </summary>
	public class CustomTableViewSource : UITableViewSource

	{
		//---- declare vars
		protected List<BasicTableViewItemGroup> _tableItems;
		protected string _customCellIdentifier = "MyCustomTableCellView";
		protected Dictionary<int, CustomTableViewCell> _cellControllers = 
			new Dictionary<int, CustomTableViewCell>();
		
		public CustomTableViewSource (List<BasicTableViewItemGroup> items)
		{
			this._tableItems = items;
		}

		/// <summary>

		/// Called by the TableView to determine how many sections(groups) there are.
		/// </summary>
		public override int NumberOfSections (UITableView tableView)
		{
			return this._tableItems.Count;
		}

		/// <summary>

		/// Called by the TableView to determine how many cells to create for that particular section.
		/// </summary>
		public override int RowsInSection (UITableView tableview, int section)
		{
			return this._tableItems[section].Items.Count;
		}

		/// <summary>

		/// Called by the TableView to retrieve the header text for the particular section(group)
		/// </summary>
		public override string TitleForHeader (UITableView tableView, int section)
		{
			return this._tableItems[section].Name;
		}

		/// <summary>

		/// Called by the TableView to retrieve the footer text for the particular section(group)
		/// </summary>
		public override string TitleForFooter (UITableView tableView, int section)
		{
			return this._tableItems[section].Footer;
		}

		/// <summary>

		/// Called by the TableView to retreive the height of the row for the particular section and row
		/// </summary>
		public override float GetHeightForRow (UITableView tableView, MonoTouch.FoundationNSIndexPath indexPath)
		{
			return 109f;
		}

		/// <summary>

		/// Called by the TableView to get the actual UITableViewCell to render for the particular section and row
		/// </summary>
		public override UITableViewCell GetCell (UITableView tableView, MonoTouch.FoundationNSIndexPath indexPath)
		{
			//---- declare vars

			UITableViewCell cell = tableView.DequeueReusableCell (this._customCellIdentifier);
			CustomTableViewCell customCellController = null;
			
			//---- if there are no cells to reuse, create a new one
			if (cell == null)
			{
				customCellController = new CustomTableViewCell ();
				// retreive the cell from our custom cell controller

				cell = customCellController.Cell;
				// give the cell a unique ID, so we can match it up to the controller
				cell.Tag = Environment.TickCount;
				// store our controller with the unique ID we gave our cell
				this._cellControllers.Add (cell.Tag, customCellController);
			}
			else
			{
				// retreive our controller via it's unique ID

				customCellController = this._cellControllers[cell.Tag];
			}
			
			//---- create a shortcut to our item
			BasicTableViewItem item = this._tableItems[indexPath.Section].Items[indexPath.Row];
			
			//---- set our cell properties

			customCellController.Heading = item.Name;
			customCellController.SubHeading = item.SubHeading;
			if (!string.IsNullOrEmpty (item.ImageName))
			{
				customCellController.Image = UIImage.FromFile ("Images/" + item.ImageName);
			}
			
			//---- return the custom cell
			return cell;
		}

	}
	//========================================================================}

}

如果你浏览一遍这个代码,就看到它几乎和BasicTableViewSource 一样,只有少许改变。

要注意到第一件事,是声明部分:

//---- declare vars
protected List<BasicTableViewItemGroup> _tableItems;
protected string _customCellIdentifier = "MyCustomTableCellView";
protected Dictionary<int, CustomTableViewCell> _cellControllers = 
	new Dictionary<int, CustomTableViewCell>();

我们添加了一个名为_cellControllers新变量。我们将在后面看到如何使用它,它会保存着自定义单元格的集合。

下一个增加的东西是GetHeightForRow 方法:

/// <summary>
/// Called by the TableView to retreive the height of the row for the particular section and row
/// </summary>
public override float GetHeightForRow (UITableView tableView, MonoTouch.FoundationNSIndexPath indexPath)
{
	return 109f;
}

当我们创建自定义单元格控制器之后,我们让它比通常的单元格要高。在数据绑定的过程中,CocoaTouch 需要知道要给这个单元格分配多少空间。这就是要调用GetHeightForRow 方法的缘由。如果我们不告知新的大小,那么系统会按照标准尺寸去调整布局,我们就会看到怪异的结果。

如果我们在Interface Builder中打开我们的单元格,并通过Size Inspector查看,会知道单元格的高度上多少。在我们的例子中,它是109像素,不过你的可能会有所不同。

最后改变的一块地方是,GetCell方法:

/// <summary>
/// Called by the TableView to get the actual UITableViewCell to render for the particular section and row
/// </summary>
public override UITableViewCell GetCell (UITableView tableView, MonoTouch.FoundationNSIndexPath indexPath)
{
	//---- declare vars

	UITableViewCell cell = tableView.DequeueReusableCell (this._customCellIdentifier);
	CustomTableViewCell customCellController = null;
	
	//---- if there are no cells to reuse, create a new one
	if (cell == null)
	{
		customCellController = new CustomTableViewCell ();
		// retreive the cell from our custom cell controller

		cell = customCellController.Cell;
		// give the cell a unique ID, so we can match it up to the controller
		cell.Tag = Environment.TickCount;
		// store our controller with the unique ID we gave our cell
		this._cellControllers.Add (cell.Tag, customCellController);
	}
	else
	{
		// retreive our controller via it's unique ID

		customCellController = this._cellControllers[cell.Tag];
	}
	
	//---- create a shortcut to our item
	BasicTableViewItem item = this._tableItems[indexPath.Section].Items[indexPath.Row];
	
	//---- set our cell properties

	customCellController.Heading = item.Name;
	customCellController.SubHeading = item.SubHeading;
	if (!string.IsNullOrEmpty (item.ImageName))
	{
		customCellController.Image = UIImage.FromFile ("Images/" + item.ImageName);
	}
	
	//---- return the custom cell
	return cell;
}

这个方法开始非常类似于BasicTableViewSource 类,我们尝试通过DequeueReusableCell 的调用来从缓存池中重用的一个单元格。从这之后,就变得复杂了。如果我们不能在重用的时候得到单元格,那么我们必须去创建一个新的。它就是由我们的CustomTableViewCell 类所创建的,它实际上是一个包含着自定义单元格的控制器。

一旦我们创建了控制器,我们就把cell变量赋值控制器的Cell属性。

我们接着为单元格添加了一个唯一标识符,以便我们在后面能把它和正确的CustomTableViewCell 控制器关联在一起。我们使用Environment.TickCount ,因为它提供了比较稳妥的唯一性值。如果我们想,也可以使用Guid.NewGuid,不过调用它稍微有点昂贵。

接下来,我们使用相同的tag标识,来创建存储在CustomTableViewCell 的字典对象。

这也就是我们下面这行代码显而易见的原因:

else
{
	// retreive our controller via it's unique ID
	customCellController = this._cellControllers[cell.Tag];
}

如果我们找到一个可重用的单元格,那么就需要通过控制器来设置相关属性。为了这样,必须使用之前我们使用过的标识符从Dictionary中提取出来。

到这里,已经涉及了对这个类的大部分改变。接下来的几行,为了改变控制器类中的属性,进行了相对于单元格本身较简单的修改。

好了!我们快要完成了。打开Main.cs文件,我们对AppDelegate类进行两个地方的改变,让其使用我们的CustomTableViewSource 而非BasicTableViewSource。

首先,注释掉这行:

BasicTableViewSource _tableViewSource; 

并紧接着后添加这行:

CustomTableViewSource _tableViewSource; 

接着,在CreateTableItems 方法中,注释掉这行:

this._tableViewSource = new BasicTableViewSource(tableItems); 

并紧接着后面添加这行:

this._tableViewSource = new CustomTableViewSource(tableItems); 

我们修改后的AppDelegate 类看起来如下:

// The name AppDelegate is referenced in the MainWindow.xib file.
public partial class AppDelegate : UIApplicationDelegate
{
	//BasicTableViewSource _tableViewSource;

	CustomTableViewSource _tableViewSource;
	
	// This method is invoked when the application has loaded its UI and its ready to run
	public override bool FinishedLaunching (UIApplication app, NSDictionary options)
	{
		this.CreateTableItems ();
		this.tblMain.Source = this._tableViewSource;

		// If you have defined a view, add it here:

		// window.AddSubview (navigationController.View);
		window.MakeKeyAndVisible ();
		
		return true;
	}

	// This method is required in iPhoneOS 3.0
	public override void OnActivated (UIApplication application)
	{
	}
	
	/// <summary>

	/// Creates a set of table items.
	/// </summary>
	protected void CreateTableItems ()
	{
		List<BasicTableViewItemGroup> tableItems = new List<BasicTableViewItemGroup> ();
		
		//---- declare vars

		BasicTableViewItemGroup tGroup;
		
		//---- birds
		tGroup = new BasicTableViewItemGroup() { Name = "Birds", Footer = "Birds have wings, and sometimes use them." };
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Crow", SubHeading = "AKA, Raven.", ImageName = "PawIcon.png" });
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Chicken", SubHeading = "Males are called roosters.", ImageName = "PushPinIcon.png" });
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Turkey", SubHeading = "Eaten at thanksgiving.", ImageName = "LightBulbIcon.png" });
		tableItems.Add (tGroup);
	
		//---- fish

		tGroup = new BasicTableViewItemGroup() { Name = "Fish", Footer = "Fish live in water. Mostly." };
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Trout", SubHeading = "Rainbow is a popular kind.", ImageName = "TargetIcon.png" });
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Salmon", SubHeading = "Good sushi.", ImageName = "PawIcon.png" });
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Cod", SubHeading = "Flat fish.", ImageName = "LightBulbIcon.png" });
		tableItems.Add (tGroup);
	
		//---- mammals

		tGroup = new BasicTableViewItemGroup() { Name = "Mammals", Footer = "Mammals nurse their young." };
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Deer", SubHeading = "Bambi.", ImageName = "PushPinIcon.png" });
		tGroup.Items.Add (new BasicTableViewItem() { Name = "Bats", SubHeading = "Fly at night.", ImageName = "TargetIcon.png" });
		tableItems.Add (tGroup);
		
		//this._tableViewSource = new BasicTableViewSource(tableItems);

		this._tableViewSource = new CustomTableViewSource(tableItems);
	}
}		

运行这个应用程序,就能看到下面的效果:

在MonoTouch中自定义表格_第29张图片

如果你在Interface Builder中把表格风格改为Grouped,保存改变,再次运行程序,你就会看到下图:

在MonoTouch中自定义表格_第30张图片

恭喜!做了这么多的工作,终于完成了,不过你也学到了如何在MonoTouch中自定义表格。现在,我们已经让其运行起来了,来看一下在进行自定义单元格的时候,要考虑到一些事项。

性能考虑

如果没有正确地处理自定义单元格的开发,在使用UITableView 的时候会造成严重的性能问题。特别在你有很多行的时候更是如此。iPhone,虽然令人印象深刻,不过却只有性能有限的处理器,而为了获得用户所期望的较好响应能力,你应该考虑几个性能优化方式。

另外,尽早部署到设备上经常性地评估自定义表格的性能,是一种可取的做法。模拟器就是一个模拟器而已,并非真正的设备。它比设备运行的要快得多,如果你依赖于模拟器来测量应用程序的性能,那么你很可能会在部署到设备上的时候大失所望。

而且,在你测试自定义表格的时候,如果用户能添加自己的行,那么你应该测试应用程序有很多行的性能。如果它依然“活蹦乱跳”,具有很好的响应,那么你就能确信你已经开发正确,而你的用户应该不会对性能失望。

  • 单元格重用 - 单元格重用是获得具有良好响应表格的第一个技术。特别在具有大量的行的时候,更是需要。如果你不重用单元格,那么iPhone OS不得不在每个单元格显示的时候去创建一个新的实例。这马上就会变成一个严重的问题。为了确定你的单元格是否正被重用,建议在单元格重用代码中使用Console.WriteLine 把重用的过程打印到应用程序控制台。确保在第一次显示界面的时候,添加了足够多的行,以便在滚动屏幕的时候,OS有机会重用老的已经被滚动出屏幕的单元格。本文章的例子就展示了如何正确地重用单元格,如果你的单元格没有重用,研究一下代码示例,确保所有实现都是正确的。
  • 缓存行高 - 表格会经常性地获取行的高度。实际上,它会在每次单元格创建的时候都获取一遍,在某些时候甚至会更频繁。如果你基于单元格内容来计算行高,那么确保要缓存这个值,以便你不必总是计算它。实际上,你可能会在单元格控制器中创建一个属性,计算,然后缓存之。
  • 缓存图片 - 如果你正使用图片,考虑缓存它们,以便不必每次显示的时候都从文件中载入。如果单元格之间会共享图片,可以考虑把他们放到一个字典对象中,并从里面来获取图片实例。要小心不要加载太多图片。用到可供你支配的iPhone内存的一半是不太正常的,因此如果你有大量的图片,你就要做出选择,是从文件中加载它们,还是在缓存字典中只保留一定数量的图片,没有的时候再从文件中加载。
  • 远离透明效果 - 在iPhone上执行的一个非常昂贵的操作就是渲染透明效果。在iPhone上有两个绘图系统,CoreGraphics和CoreAnimation。CoreGraphics 利用GPU,而CoreAnimation根据要处理内容的快慢也利用主处理器,不过通常主要使用GPU。iPhone的GPU的问题在于它没有针对颜色混合进行优化。因此,你应该尽可能尝试避免透明效果。如果你确实不能避免,那么你应该通过重写DrawRect 方法来自己完成混合过程,并直接处理绘图计算,关于这点我们将在下一条中详细讲到。
  • 手动在DrawRect中绘制单元格 - 要解决上面提到的性能问题的最后努力,就是重写DrawRect 方法,自己执行绘图。然而这也有缺点。首先,在技术上相对复杂,第二,它会占用大量内存。就这点而言,它更适合那些没有大量行的表格,不过这样也会占用大量的处理器资源。对这个技术更多的信息,可以参考苹果示例程序的第15个例子——TableViewSuite,下面会给出注释。
  • 避免复杂的图形计算 - 正如透明效果问题一下,尽量远离那些需要计算的图形元素,比如在显示的时候把图片处理为渐变效果。
  • 编程创建单元格 - 如果你已经想方设法进行优化了,依然还是需要进一步提升性能,那么你可以不用Interface Builder来创建自定义UITableViewCell ,而是编程手写这个控件。关于编程构建视图的更多信息,可访问Craig Dunn的博客帖子。要学习如何不使用Interface Builder来创建MonoTouch应用程序,可以阅读MonoTouch.info里面列出的文章,在这里:http://monotouch.info/Tags/NoIB

展示进行性能优化的更多例子,可以访问苹果的TableViewSuite示例应用程序。

它虽然是用Objective-C编写的,不过概念是相同的。

你可能感兴趣的:(在MonoTouch中自定义表格)