UITableView con índices

En el ejemplo de hoy nos hemos basado en el tercer caso práctico de TableViewSuite de iPhone Dev Center. (Podéis descargarlo en http://developer.apple.com/iphone/library/samplecode/

TableViewSuite/index.html )

UITableView, es una de las clases más utilizadas, pues nos permite mostrar información en forma de lista y puede ser ordenada, agrupada y localizada de forma sencilla.

En el ejemplo de hoy, vamos a mostrar una sencilla lista de zonas horarias, ordenadas por orden alfabético, con la primera letra de cada región como cabecera de la sección y con un índice para acceder de forma rápida.

Para obtener la información de las zonas horarias, en nuestra clase delegada de UIApplication, obtenemos dicha información mediante la clase abstracta NSTimeZone, a través de su propiedad knownTimeZoneNames en una variable de tipo NSArray aunque en nuestro caso preferimos hacerlo con una del tipo NSMutableArray (hereda de NSArray y por lo tanto implementa operaciones básicas de inserción y eliminación de elementos en la lista).

Hemos preferido NSMutableArray ya que está indicada para el manejo personalizado de la lista, y al ser una subclase de NSArray nos permitirá implementar métodos como:

En nuestra clase controladora, heredaremos de UITableViewController para manejar nuestro TableView. Aprovecharemos su método initWithStyle para aplicar un estilo a nuestro TableView (ya visto en nuestra clase delegada de UIApplication con initWithStyle:UITableViewStylePlain). Podéis probar con el estilo UITableViewStyleGrouped y comprobar vosotros mismo el cambio.

-Métodos de UITableViewDataSource
En nuestra clase controladora vamos a sobreescribir algunos métodos necesarios para el correcto funcionamiento de la aplicación. En concreto son de la clase UITableViewDataSource que son llamados a partir del objeto UITableView por medio de eventos.

1. numberOfSectionsInTableView

Método opcional de la clase UITableViewDataSource, que será llamado en el momento que hayamos insertado todos los datos, si nos fijamos en la pila de llamadas a través de:

Como no hay mejor manera de aprender, que comprobar por nosotros mismos ciertos comportamientos, en lugar de devolver el número de secciones de nuestro TableView, pongamos un 2 (return 2;).

2. numberOfRowsInSection

Al igual que el método anterior, a través de UITableViewDataSource, devolvemos el número de regiones de cada sección, el cual es llamado desde:

3. titleForHeaderInSection

Pregunta al DataSource por el título de la cabecera de la sección especificada.

4. sectionIndexTitlesForTableView

Pregunta al DataSource para que devuelva los títulos para las secciones del TableView.

5. sectionForSectionIndexTitle

Pregunta al DataSource para devolver el índice de una sección.

* Si obviamos estos tres últimos métodos, veremos como los datos aparecen de forma plana, sin cabeceras ni índices. Es conveniente comentar cada uno de ellos para ver el resultado y comprender mejor el ejemplo.

-Métodos de UITableView

1. cellForRowAtIndexPath

Devuelve el valor de una determinada fila o celda a partir de un índice.

Para finalizar, una de las funciones más importantes en nuestro ejemplo de hoy es la encargada de rellenar la información que será mostrada. Para ello, mediante un objeto diccionario de la clase NSMutableDictionary nos dispondremos a rellenarlo.

El diccionario indexedTimeZones irá rellenando cada una de las letras de las regiones en una variable CFString y en otro diccionario hijo (timeZoneDictionary) las zonas horarias que empiezen por esa letra. A continuación se ordenará el primer diccionario y por cada una de las letras se ordenarán igualmente los diccionarios que contienen (sortUsingDescriptors:sortDescriptors).

Nota: Interesante detalle el de mostrar una imagen nada más iniciar la aplicación, dado que nos lleva un tiempo el cargar la información de las zonas horarias. La imagen es una captura de la propia aplicación, así de esa manera, evitamos un desagradable efecto.

One Response to “UITableView con índices”

1. Iphone » UITableView con índices says:

   5 May, 2008 at 09:41

   [...] iPhone Software wrote an interesting post today on UITableView con índicesHere’s a quick excerptEn el ejemplo de hoy nos hemos basado en el tercer caso práctico de TableViewSuite de iPhone Dev Center…. [...]