Tutorial: Personalización de títulos de elemento en un formulario de presentación de dispositivo móvil

En este tutorial se muestra cómo personalizar la representación de los campos de las páginas móviles implementando una RenderingTemplate personalizada. El ejemplo muestra cómo personalizar, en la página de presentación móvil, el campo Título en un elemento de una lista Anuncios. Para obtener información general sobre los pasos para personalizar los campos de las páginas móviles, consulte Procedimiento para personalizar la representación de campos en páginas móviles.

Según se describe en Sistema de representación de páginas móviles, se llama a un control de selector de plantillas Microsoft.SharePoint.MobileControls.SPMobileListFieldSelector mediante una cadena de llamadas, desde un control de la página.

Este objeto determina, en función del tipo de lista y el campo actuales (anuncios y título respectivamente en este ejemplo), qué RenderingTemplate representa el campo en la página de presentación móvil.

El control busca un elemento RenderingTemplate llamado **MobileCustomListField_ListTypeID_FieldType_**Field.

ListTypeID es el número de identificador del tipo de la lista actual (por ejemplo, 105) o uno de los valores de la enumeración SPListTemplateType (por ejemplo, Contacts). FieldType es el tipo de datos del campo, por ejemplo, Text o Number, y Field es el nombre del campo, como WorkPhone. Si no existe RenderingTemplate con ese identificador, se utiliza el RenderingTemplate con el identificador MobileDefaultListField.

Cuando se incluye Windows SharePoint Services 3.0, no hay RenderingTemplate con el identificador de MobileCustomListField_Announcements_Text_Title. En este tutorial creará uno que sustituye, en la página de presentación móvil de un elemento de la lista Anuncios, un título nuevo para el elemento.

Para personalizar el campo Título de un elemento Anuncios:

1. Con cualquier editor de texto, cree un archivo de texto (UTF-8) con el nombre AnnouncementsItemDisplayPageTitleField.ascx en la carpeta unidad_local:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\CONTROLTEMPLATES.

2. Agregue las siguientes directivas de página al archivo .ascx:

   <%@ 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. A continuación de las directivas, agregue una RenderingTemplate y asígnele el identificador que busca el objeto SPMobileListContents en el formulario de presentación: MobileCustomListField_Announcements_Text_Title.

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

4. Dentro del elemento RenderingTemplate defina un elemento Template que tenga un control secundario Label. Establezca el atributo de la etiqueta Text como se muestra a continuación:

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

5. Guarde y cierre el archivo.

6. Restablezca Servicios de Microsoft Internet Information Server (IIS), escribiendo iisreset en una línea de comandos.

7. Si está utilizando un emulador de dispositivos en un equipo, en vez de un dispositivo móvil real, deberá eliminar los archivos temporales de Internet.

8. Vaya a la lista Anuncios con su emulador o dispositivo. Haga clic en un elemento para que aparezca. Debe ver el nuevo título tal y como se muestra en la siguiente captura de pantalla:

Vea también

Otros recursos

Diseño y paginación de las páginas móviles
Procedimiento para personalizar la representación de campos en páginas móviles
Sistema de representación de páginas móviles