{"id":7335,"date":"2011-08-01T15:59:37","date_gmt":"2011-08-01T13:59:37","guid":{"rendered":"http:\/\/www.devapp.it\/wordpress\/?p=7335"},"modified":"2011-09-09T17:24:06","modified_gmt":"2011-09-09T15:24:06","slug":"t099-scopriamo-la-property-tag-e-impariamo-ad-usarla-durante-lo-sviluppo-di-applicazioni-ios","status":"publish","type":"post","link":"https:\/\/www.devapp.it\/wordpress\/t099-scopriamo-la-property-tag-e-impariamo-ad-usarla-durante-lo-sviluppo-di-applicazioni-ios\/","title":{"rendered":"T#099 – Scopriamo la property TAG e impariamo ad usarla durante lo sviluppo di Applicazioni iOS"},"content":{"rendered":"

\"property-TAG-sviluppo-Applicazioni-iOS-iPhone-iPad-00\"<\/a> In questo nuovo tutorial di programmazione iPhone e iPad rispondiamo ad alcune richieste che arrivano dal nostro forum<\/a> e nello specifico concentreremo la nostra attenzione su una particolare property presente in tutti gli oggetti dell’UIKit, il tag<\/strong>, ovvero un identificativo numerico che possiamo associare ad un nostro particolare oggetto. Questa propriet\u00e0, anche se sembra banale, \u00e8 in realt\u00e0 molto importante e ci permette di rintracciare i nostri oggetti in alcuni casi particolari. Andiamo a scoprire insieme di cosa si tratta.<\/p>\n

Per capire il motivo dell’importanza della propriet\u00e0 “tag” dobbiamo analizzare cosa succede quanto creiamo un oggetto nella nostra applicazione. Vediamo un piccolo esempio.<\/p>\n

Per creare all’interno della nostra app un qualsiasi oggetto facente parte dell’UIKit siamo soliti utilizzare un’istruzione simile alla seguente:<\/p>\n

\r\nUILabel * lblIp = [[UILabel alloc] initWithFrame:CGRectMake(75, 110, 150, 20)];\r\n<\/pre>\n
Cos\u00ec facendo non facciamo altro che definire un puntatore ad un oggetto di tipo UILabel chiamato “lblIp”. Attenzione, perch\u00e8 mentre lo sviluppatore associa il nome lblIp<\/em> all’oggetto, il compilatore associa “lblIp” ad un indirizzo di memoria, che di fatto andr\u00e0 poi a puntare al nostro oggetto vero e proprio. A questo punto, quindi, il nostro oggetto avr\u00e0 un retain uguale a 1, necessiter\u00e0 di risorse (memoria) per poter essere utilizzato.<\/p>\n

\n\"property-TAG-sviluppo-Applicazioni-iOS-iPhone-iPad-01\"<\/a>
\n<\/center><\/p>\n
Solitamente, a questa prima riga di codice, seguono altre istruzioni in cui settiamo tutte le propriet\u00e0 che ci interessano della nostra Label (nelle istruzioni di esempio che seguono settiamo solo la nuova property “tag” su cui ci stiamo focalizzando, ma \u00e8 sott’inteso che potremo personalizzare tutto quanto sar\u00e0 necessario):<\/p>\n
\r\nlblIp.tag = 10;\r\n<\/pre>\n
Ora che abbiamo il nostro oggetto personalizzato, ci interesser\u00e0 sicuramente aggiungerlo ad una view all’interno della nostra applicazione, per farlo scriveremo:<\/p>\n
\r\n[view addSubview:lblIp];\r\n<\/pre>\n
Fermiamoci un attimo e vediamo cosa \u00e8 successo a questo punto. Il nostro oggetto \u00e8 stato aggiunto alla nostra vista “view”, il suo retain vale ora 2 e, se vogliamo che la vita del nostro oggetto, la label, sia gestita da ora in avanti dalla vista, dovremo rilasciarlo tramite la seguente istruzione:<\/p>\n
\r\n[lblIp release];\r\n<\/pre>\n
Ecco che il retain della nostra label torna a 1 (grazie al rilascio) ma cosa pi\u00f9 importante, oltre ad aver aggiunto il nostro oggetto alla view, con il rilascio abbiamo definitivamente perso il puntatore all’oggetto.<\/p>\n
Ma se abbiamo perso questo importante riferimento, come possiamo usare ora la nostra label nel resto del programma?<\/p>\n
Grazie proprio alla property tag!<\/p>\n
Il tag, come accennato ad inizio articolo, non \u00e8 nient’altro che un identificativo numerico che assoceremo ai nostri oggetti. Questo identificativo dovr\u00e0 essere un numero intero maggiore o uguale a zero e il suo scopo \u00e8 proprio quello di recuperare un oggetto non avendo pi\u00f9 a disposizione il suo puntatore.<\/p>\n
Ecco spiegato come la propriet\u00e0 tag<\/em> possa tornarci utile, \u00e8 evidente la sua importanza, non credete? <\/p>\n
E’ chiaro che se abbiamo creato e personalizzato un oggetto \u00e8 nostro interesse utilizzarlo nel programma che stiamo realizzando. Per recuperare la label dell’esempio quindi, dopo averne fatto il release, dovremo scrivere:<\/p>\n
\r\nUILabel * lblTemp = (UILabel*)[view viewWithTag:10];\r\n<\/pre>\n
Naturalmente dobbiamo far capire al programma che l’oggetto che stiamo recuperando \u00e8 di tipo UILabel<\/em> e quindi facciamo il casting alla view che viene ritornata dal metodo [viewWithTag:10]<\/em>.<\/p>\n
Questa operazione \u00e8 possibile con tutti gli oggetti che fanno parte del framework UIKit, perch\u00e9 ereditano tutti da UIView<\/em>.<\/p>\n
Esempio pratico<\/h4>\n
Detto questo passiamo ad un esempio pi\u00f9 pratico. Supponiamo di avere una UITableView e che in ogni cella vogliamo inserire un bottone custom. Ecco sorgere il primo problema: come possiamo capire poi, durante l’utilizzo, a quale bottone corrisponde l’evento che abbiamo aggiunto?<\/p>\n
La risposta \u00e8 semplicissima, usiamo i tag<\/strong>!<\/p>\n
Vediamo come. Creiamo un nuovo progetto di tipo “Navigation-based”, arriverem\u00f2 cos\u00ec direttamente al sodo senza perderci in troppe chiacchiere e avremo a disposizione una bella tableView gi\u00e0 pronta su cui lavorare.<\/p>\n
Modifichiamo quindi il codice come segue:<\/p>\n
File RootViewController.h<\/p>\n
\r\n@interface RootViewController : UITableViewController\r\n{\r\n    NSArray * arraySource;\r\n}\r\n-(void)showTagButton:(id)sender;\r\n@end\r\n<\/pre>\n
Abbiamo aggiunto un semplice array che ci servir\u00e0 per inserire alcuni elementi nella nostra tabella, e il metodo che verr\u00e0 richiamato al tap su du un bottone (che aggiungeremo a breve nelle celle).<\/p>\n
Il sender \u00e8 molto importante perch\u00e9 ci permette di recuperare l’oggetto a cui \u00e8 stato aggiunto l’evento, da quest’oggetto recuperiamo il tag e cos\u00ec facendo abbiamo l’elemento esatto del nostro array (pi\u00f9 difficile dirlo a parole che a farlo via codice:))<\/p>\n
Passiamo al file di implementazione “RootViewController.m” e modifichiamolo come segue:<\/p>\n
\r\n- (void)viewDidLoad\r\n{\r\n    [super viewDidLoad];\r\n    arraySource = [[NSArray alloc] initWithObjects:@\"primo\",@\"secondo\",@\"terzo\",@\"quarto\",@\"quinto\", nil];\r\n}\r\n<\/pre>\n
Qui non abbiamo fatto altro che allocare “arraySource” (il nostro array) e inizializzarlo con cinque stringhe di esempio.<\/p>\n
\r\n- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section\r\n{\r\n    return [arraySource count];\r\n}\r\n<\/pre>\n
Settiamo il numero di righe per sezione (nel nostro esempio abbiamo una sola sezione) e finalmente creiamo la nostra cella personalizzata, quella che conterr\u00e0 i vari button:<\/p>\n
\r\n- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath\r\n{\r\n    static NSString *CellIdentifier = @\"Cell\";\r\n    \r\n    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];\r\n    if (cell == nil) \r\n    {\r\n        cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:CellIdentifier] autorelease];\r\n        \r\n        \/\/Creiamo il nostro UIButton\r\n        UIButton * btnShow = [UIButton buttonWithType:UIButtonTypeCustom];\r\n        \/\/Lo personalizziamo\r\n        [btnShow setBackgroundImage:[UIImage imageNamed:@\"btnAdd.png\"] forState:UIControlStateNormal];\r\n        [btnShow setTitle:@\"tag\" forState:UIControlStateNormal];\r\n        [btnShow setTitleColor:[UIColor whiteColor] forState:UIControlStateNormal];\r\n        btnShow.frame = CGRectMake(200, 10, 70, 30);\r\n        \/\/Impostiamo la property tag di ogni button in modo che sia uguale all'indice della riga dove risiede ogni bottone\r\n        btnShow.tag = indexPath.row;\r\n        [btnShow addTarget:self action:@selector(showTagButton:) forControlEvents:UIControlEventTouchDown];\r\n        [cell.contentView addSubview:btnShow];\r\n    }\r\n    \/\/ Configure the cell.\r\n    cell.textLabel.text = [arraySource objectAtIndex:indexPath.row];\r\n    \r\n    return cell;\r\n}\r\n<\/pre>\n
La prima modifica che facciamo \u00e8 quella di cambiare il tipo di cella in UITableViewCellStyleSubtitle<\/em> poi sempre dentro l’if creiamo il nostro bottone. Ricordiamoci la parte pi\u00f9 importante, quella del tag. In questo caso non occorre rilasciare in quanto i button sono stati creati tramite “buttonWithType”, anzich\u00e8 tramite il metodo “alloc\/init”, sono quindi in autorelease e non siamo noi responsabili della loro gestione (se avete dubbi in merito, andate a rispolverare qualche articolo sulla gestione della memoria sulle nostre pagine).<\/p>\n
Fatto questo impostiamo il titolo alla cella con la stringa presa dall’arraySource.<\/p>\n
A questo punto non ci rimane che implementare il metodo showTagButton:<\/em><\/p>\n
\r\n-(void)showTagButton:(id)sender\r\n{    \r\n    UIButton * btnTemp = (UIButton*)sender;\r\n    int row = btnTemp.tag;\r\n    NSString * rowString = [NSString stringWithFormat:@\"tag: %i\",row];\r\n    UIAlertView * alert = [[UIAlertView alloc] initWithTitle:[arraySource objectAtIndex:row]\r\n                                                     message:rowString\r\n                                                    delegate:self cancelButtonTitle:@\"Ok\" \r\n                                           otherButtonTitles:nil];\r\n