WSS3SDK之：演练--在mobile的显示窗体中定制列表项标题

本次演练中将向大家展示如何通过实现一个自定义RenderingTemplate控件来对mobile页面中字段的渲染进行定制。示例展示了如何在mobile的显示页面中定制通知列表的项的标题字段的显示。

正如先前在mobile页面渲染机制一节所描述的，一个Microsoft.SharePoint.MobileControls.SPMobileListFieldSelector 模板选取器控件会被调用，并通过一条链的调用，最终找到显示在页面中的控件。

基于当前的列表类型和字段（比如本例中的通知和标题），该对象决定了哪个RenderingTemplate会用于在mobile显示页面上渲染该字段。

该控件搜寻 RenderingTemplate 对象名称 MobileCustomListField_ListTypeID_FieldType_Field，其中 ListTypeID 可以是当前列表类型的ID号（如105），也可以是SPListTemplateType枚举的一个值（如Contacts）。FieldType 是字段的数据类型。比如，Text或Number。Field 是字段的内部名称，比如WorkPhone。如果该ID不存在，则使用ID为MobileDefaultListField的 RenderingTemplate 对象。

WSS 3.0并没有内置ID为MobileCustomListField_Announcements_Text_Title的RenderingTemplate。在本次演练中，您将创建一个新的用于通知列表的列表项标题字段的模板，来替换默认模板。

定制通知项的标题：

  1. 在文本编辑器中，创建一个文本文件 (UTF-8)，命名为AnnouncementsItemDisplayPageTitleField.ascx。存放在 Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES目录下。

  2. 添加下列指向标记到文件中：

    <%@ Control Language="C#" %>
    <%@ Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
    <%@ Register 
    TagPrefix="mobile" Namespace="System.Web.UI.MobileControls" Assembly="System.Web.Mobile, Version=1.0.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" %>
    <%@ Register 
    TagPrefix="SharePoint" Namespace="Microsoft.SharePoint.WebControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
    <%@ Register 
    TagPrefix="SPMobile" Namespace="Microsoft.SharePoint.MobileControls" Assembly="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %>
    <%@ Import Namespace="Microsoft.SharePoint" %>

  3. 然后，在其下面添加一个RenderingTemplate 对象，设置其 ID 为 显示页面所搜索的 SPMobileWebTitle 对象的ID：MobileCustomListField_Announcements_Text_Title。

    <SharePoint:RenderingTemplate RunAt="Server" ID="MobileCustomListField_Announcements_Text_Title" >
    </SharePoint:RenderingTemplate>

  4. 在 RenderingTemplate 元素中，定义一个 Template 元素来包含一个 Label 子控件。设置label的属性如下：

    <Template>
          <mobile:Label Text="Title field in Announcements List" RunAt="Server" />
    </Template>

  5. 保存并关闭该文件。

  6. 重启Internet Information Services (IIS) 。可以在命令行里使用iisreset命令来重启IIS。

  7. 如果您使用的是电脑上的设备模拟器，而不是真正的mobile设备，您可能还需要删除Internet临时文件。

  8. 通过您的设备或模拟器导航到某个通知列表。点击一项通知进入其显示页面。您将看到新定制的标题，正如下面的屏幕截图所示：

posted @ 2008-07-23 23:05  Sunmoonfire  阅读(539)  评论(0)  编辑  收藏  举报