WatchKit编程指南：WatchKit Apps--表格.doc

本文翻译自Apple Watch Programming Guide：WatchKit Apps-Tables，敬请勘误。使用table展示内容可动态更改的列表数据。WatchKit 仅支持使用WKInterfaceTable类的单列表格。想要在table中展示数据，需要先为数据定义布局，并在运行时通过编码填写表数据。您需要在Xcode工程中做以下事情：在storyboard文件中：给界面控制器场景添加table对象，并在界面控制器中为table创建一个outlet。像Configuring Row Types描述的那样为table配置一个或多个row types。在代码中:为依照Configuring Row Types定义的row type定义一个row controller 类。在初始化阶段，依照Configuring the Tables Contents at Runtime向table中添加行按照Handling Row Selections所述响应用户与表格行的交互。您可以为每个table定义多个行类型，每种类型都有不同的外观。在运行时，您可以指定所需行类型以及它们在table中的排列顺序。对于如何配置table的详细信息，请参看WKInterfaceTable Class Reference.配置Row TypesRow Type是一个在table中以单行形式展示数据的模板。每个table必须至少有一个row type，您可以根据需求定义额外的row type。您可以用row type区分table中的不同内容。比如您可能在内容行上、标题和注脚上使用不同的类型。当您为界面控制器场景添加table时，Xcode会自动创建初始的row types供您配置。为table添加row types：在storyboard文件中选中table对象打开Attributes inspector.使用Rows属性更改可用row type数量。每个row type最初都包含一个单个组元素。您可以为该组元素添加标签、图片以及其他所需对象。标签和图片的真实内容通常是无关紧要的。在运行时，作为配置工作的一部分，您可以替换界面对象的内容。想要在运行时管理表格行的内容，您需要提供一个自定义的row controller 类。大部分row controller类包含少量代码，或者根本就不包含代码，它们主要用来访问那些包含界面对象的outlets。不过，如果您在表格行中添加了按钮或者其他控件，那么其类也会包含一些动作方法，以响应用户与控件的交互。为row type定义一个row controller类：为WatchKit扩展添加一个新的Cocoa Touch类让新类继承NSObject。为每个计划在运行时访问的标签、图片或者控件添加声明的属性。声明属性可使用以下格式，请更改类以匹配相应的界面对象：property(weak,nonatomic)IBOutletWKInterfaceLabel*label;Listing 10-1 展示了一个用于管理row type的示例类interfaceMainRowType:NSObjectproperty(weak,nonatomic)IBOutletWKInterfaceLabel*rowDescription;property(weak,nonatomic)IBOutletWKInterfaceImage*rowIcon;end您可以在storyboard文件中完成row type配置。配置表格行要求设置其类，并将任何outlets连接到对应的界面对象上。您还必须提供一个方法，以便通过命名row type在运行时辨别表格行。在storyboard中配置row type：在storyboard文件中选中row controller对象。将row controller的Identifier属性设置为唯一值，随后您会在创建表格行时使用该标识符。 在行类型中该值必须是唯一的，但是实际值还是由您来定夺。在Attributes inspector中设置该值。将row type的类设置为您的自定义类。您需要在Identity inspector中设置类信息。 将row type元素和类中对应的outlets连接起来。将storyboard文件中的项目和outlets连接并绑定。当您在代码中配置table时，WatchKit会在运行时使用该信息实例化对应的类。Figure 10-1 在Xcode中配置一个命名为”Main Row Type”的row type，并设置为使用Listing 10-1中定义的MainRowType类。该类中的rowDescription 和rowIcon outlets被连接到行中的图片和标签。运行时配置table内容在运行时，您可以为table添加表格行并以编程形式配置其内容。通常，添加并配置表格行是初始化界面控制器过程中的一部分。创建并配置列表行先决定你需要创建的行的数目和类型，这取决于你想要展示的数据类型。使用setRowTypes:或者setNumberOfRaws:withRowType:方法来创建。这两个方法都会在界面上创建新的列表行，并且会在WatchKit扩展中实例化对应的类。这些实例被保存在table中，且可通过rowControllerAtIndex:方法访问。使用rowControllerAtIndex:方法遍历表格中的每一行。使用row controller对象来配置每一行中的内容。setRowType:和setNumberOfRaws:withRowType:方法实例化与storyboard文件中对应的行类型相关的类。在调用这些方法之后，紧接着就可以直接获取最新创建的row controller对象了，当然还可以通过这些对象来设置内容。下面的Listing 10-2这段代码则是一个能创建新行并对其进行配置的简单示例。在这个例子里，使用的是在代码Listing 10-1中定义的MainRowType类，以及自定义的MyDataObject类，MyDataObject类用于提供table中用于行内容的数据。在setNumberOfRaws:withRowType:方法中设置好数据对象之后，代码会遍历该对象，并使用它们配置表格中每一行的内容。Listing 10-2 创建并配置table中的行-(void)configureTableWithData:(NSArray*)dataObjectsself.tablesetNumberOfRows:dataObjectscountwithRowType:”mainRowType”;for(NSIntegeri=0;i表格行的选中处理界面控制器负责处理table中的行选中操作。当用户点击table中的某一行，WatchKit会选中该行并调用WatchKit扩展中正确的方法。您可以在以下地方处理表格行的选中操作：界面控制器的table:disSelectRowAtIndex:方法中。界面控制器自定义的动作方法中。您可以使用以上两者之一来处理行选中事件。如果您的界面控制器有多个table，那推荐使用一个动作方法，因为您无需判定操作跟哪个table有关。如果您使用了一个动作方法，那需要遵循