{"id":8459,"date":"2012-01-23T14:00:42","date_gmt":"2012-01-23T13:00:42","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=8459"},"modified":"2012-03-07T12:25:26","modified_gmt":"2012-03-07T11:25:26","slug":"10-objective-c-uitableview-parte-2","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/10-objective-c-uitableview-parte-2\/","title":{"rendered":"10. Objective-C: UITableView (parte 2)"},"content":{"rendered":"

Nella lezione precedente<\/a>, abbiamo visto come risulta facile mostare una serie di elementi all’interno di una table view. Come primo argomento della lezione di oggi, vedremo come raggruppare una serie di elementi tra loro. Successivamente, sposteremo la nostra attenzione sulla ricerca ed indicizzazione all’interno di una table view.<\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-01\"<\/a>
\n<\/center><\/p>\n

Adattamento della sorgente di dati<\/h4>\n

Se guardiamo la figura sopra, risulta ovvio come i nostri dati debbano essere raggruppati in due sezioni distinte: nazioni visitate e nazioni da visitare. Abbiamo bisogno, quindi, di modificare la nostra sorgente di dati in maniera da rispecchiare queste informazioni in maniera veloce ed immediata. Come sorgente di dati continueremo ad utilizzare un NSMutableArray. Stavolta, lo popoleremo con due oggetti di tipo NSDictionary<\/strong>.<\/p>\n

Gli oggetti NSDictionary conterranno una coppia chiave\/valore, dove la chiave sara’ una stringa ed il valore sara’ un array contenente tutte le nazioni. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-02\"<\/a>
\n<\/center><\/p>\n

Creiamo due array: uno contenente le nazioni da visitare e l’altro contenente quelle gia’ visitate. Gli array sono usati per creare due oggetti NSDicitionary con la chiave “Countries”. Entrambi gli oggetti NSDictionary sono aggiunti all’array della lezione precedente, listOfItems. <\/p>\n

Preparare la UITableView per mostare i dati<\/h4>\n

La nostra table view ha bisogno di conoscere quante sezioni dovranno essere mostate a schermo. Quest’informazione viene ritornata dal metodo numberOfSectionsInTableView<\/strong>. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-03\"<\/a>
\n<\/center><\/p>\n

Sara’ necessario conoscere anche il numero di elementi per ogni sezione. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-04\"<\/a>
\n<\/center><\/p>\n

L’array listOfItems contiene due elementi dizionario. Il metodo sopra, quindi, verra’ chiamato due volte. Useremo l’indice dell’array per distinguere le varie chiamate al metodo (e quindi la sezione attualmente interessata).
\nTrovato il dizionario corretto, recuperiamo l’array utilizzando la chiave Countries. Infine, ritorniamo il numero di elementi all’interno dell’array. <\/p>\n

Configurazione del testo di intestazione sezione<\/h4>\n

Abbiamo configurato il numero di sezioni e le righe per ognuna di esse. Dobbiamo ancora configurare il testo da mostrare all’inizio di ogni sezione. Quest’operazione viene effettuata dal metodo tableView:titleForHeaderInSection<\/strong>. <\/p>\n

Visto che il primo dizionario nell’array listOfItems contiene la lista delle nazioni da visitare ed il secondo quelle gia’ visitate, utilizziamo quest’informazione per selezionare il valore di section<\/strong> piu’ adatto. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-05\"<\/a>
\n<\/center><\/p>\n

Mostrare i nuovi contenuti<\/h4>\n

Adesso dobbiamo mostrare i contenuti relativamente alle due sezioni della nostra table view. La logica e’ simile a quella utilizzata nella lezione precedente. Dobbiamo prima trovare quale dizionario utilizzare, attraverso la property section<\/strong> dell’oggetto NSIndexPath<\/strong>. Una volta ottenuta la giusta sezione, utilizziamo l’array contenuto al suo interno attraverso la chiave Countries. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-06\"<\/a>
\n<\/center><\/p>\n

Selezionare la riga corretta<\/h4>\n

Il metodo tableView:didSelectRowAtIndexPath deve essere modificato in maniera da tenere in considerazione la nuova struttura dati ed aggiornare la table view. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-07\"<\/a>
\n<\/center><\/p>\n

Navigazione tramite indici<\/h4>\n

Un’altro modo per la navigazione efficiente della sorgente di dati e’ quello di dotare la nostra table view di un indice. La prima cosa da fare e’ creare un’oggetto per contenere i valori dell’indice da mostrare; utilizzeremo un NSArray a questo scopo. La documentazione Apple, suggerisce di impostare lo stile della UITableView in UITableViewStylePlain, sebbene non venga generato nessun errore con stili diversi. Il metodo che si occupa di creare e restituire l’indice delle sezioni e’ sectionIndexTitlesForTableView<\/strong>: <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-08\"<\/a>
\n<\/center><\/p>\n

Il metodo crea e ritorna un oggetto array contenente gli elementi da mostrare nella barra degli indici a destra. <\/p>\n

Gestione dell’evento di selezione indice<\/h4>\n

Alla selezione di un elemento nella barra degli indici, viene lanciato un messaggio di tableView:sectionForSectionIndexTitle:atIndex, il quale ritorna l’indice della sezione da mostrare. Dal momento che abbiamo solo due sezioni nella nostra sorgente di dati, adatteremo questo metodo per tornare sempre le nostre due sezioni. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-09\"<\/a>
\n<\/center><\/p>\n

Ricerca all’interno di una tableview<\/h4>\n

Per dotare la nostra table view di un pannello di ricerca, dobbiamo modificare leggermente il codice sorgente gia’ scritto ed aggiungere alcuni metodi necessari per la corretta gestione dell’oggetto UISearchBar<\/strong>. <\/p>\n

La prima cosa da fare e’ aggiungere la dichiarazione dei nuovi oggetti e variabili da usare all’interno della classe MyTableViewController. In particolare, dovremo dotare la nostra classe controllore di un nuovo oggetto denominato UISearchBar e di alcune variabili d’appoggio necessarie al suo funzionamento. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-10\"<\/a>
\n<\/center><\/p>\n

Dobbiamo modificare il metodo di viewDidLoad, in maniera da inizializzare correttamente le nuove variabili ed i nuovi oggetti appena dichiarati. In particolare, dovremo creare un frame per contenere la UISearchBar e dovremo, successivamente, associare al campo tableHeaderView<\/strong> il nuovo oggetto creato. Ogni table view ha due properties di tipo UIView personalizzabili dall’utente, in maniera da ospitare delle viste con contenuti speciali in testa (HeaderView) o in basso (FooterView) alla tableView. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-11\"<\/a>
\n<\/center><\/p>\n

La prima cosa da fare e’ creare un frame atto a contenere il nuovo oggetto. Inizializzeremo, quindi, un array temporaneo per conservare i risultati della ricerca attuale e due variabili booleane indicanti, rispettivamente, una ricerca in corso (searching) e la possibilita’ di selezionare o meno una riga (letUserSelectRow). Dovremo, inoltre, assegnare un delegato per l’oggetto UISearchBar. Questo significa adottare un nuovo protocollo nella nostra classe controllore ed implementare alcuni metodi per dialogare correttamente con il nuovo oggetto appena creato. <\/p>\n


\n\"objective-C-UITableView-sezioni-e-ricerca-parte-2-12\"<\/a>
\n<\/center><\/p>\n

Gestione degli eventi per la ricerca<\/h4>\n

Il protocollo UISearchBarDelegate, offre alcuni metodi per la gestione degli eventi legati alla ricerca. Prima di illustrarli e spiegarli, proviamo ad esaminare un contesto d’azione tipico legato alla ricerca. Le azioni da intraperendere quando l’utente inizia la ricerca, cliccando all’interno dell’oggetto UISearchBar, possono essere riassunte come segue: <\/p>\n