IBAction e IBOutlets: eventos e manipulação de views no iOS
18/05/2012
Na nossa aplicação Hello World, dentre as muitas coisas novas e diferentes que vimos uma das mais estranhas foi a vinculação de um método com o toque do botão. (confira todos os posts sobre iOS)
IBAction e Target-Action
Target-Action é o nome do "padrão" ou mecanismo que o iOS utiliza para lidar com eventos.
Na verdade os eventos são disparados, ou gerados, mas alguém que esteja interessado em receber mensagens destes eventos precisa ser avisado disso. Neste caso quem vai receber a mensagem é o que é chamado de target, no nosso projeto Hello World por exemplo a classe ViewController era o target.
Action é a mensagem que o controle enviará para o target. Então basicamente um controle dispara uma mensagem, notificando que algo aconteceu.
No nosso Hello World declaramos nosso método action assim:
1 #import <UIKit/UIKit.h>
2
3 @interface ViewController : UIViewController
4
5 -(IBAction)showMessage:(id)sender;
6 @end
Repare que usamos o tipo IBAction ao invés de void. Isso acontece pois, apesar de uma action não retornar nada o IBAction diz para o Interface Builder que isso é uma action e desta forma conseguimos linkar a mesma com nossos controles.
IBOutlet
Um outlet nada mais é do que uma conexão entre dois objetos. É uma variável em um objeto que guarda uma referência para outro objeto, simples assim.
Novamente o IBOutlet serve mais para o INterface Builder, para identificarmos esse tipo de variável de instância e deixarmos o Interface Builder a par disso.
Então usamos um IBOutlet para vincular um controle da nossa view de modo que alguém possa "manipular" este controle.
Evoluindo nosso Hello World
Como todo bom Hello World precisamos perguntar o nome do nosso "visitante" então vamos alterar a interface da nossa app adicionando um UITextField e um UILabel:
Feito isso vamos criar dois IBOutlets para manipularmos o label e o textfield de dentro do nosso ViewController. Mude o arquivo ViewController.h assim:
1 #import <UIKit/UIKit.h>
2 @interface ViewController : UIViewController
3
4 -(IBAction)showMessage:(id)sender;
5
6 @property (nonatomic, retain) IBOutlet UILabel *showName;
7 @property (nonatomic, retain) IBOutlet UITextField *name;
8
9 @end
(depois falaremos mais sobre o nonatomic e o retain utilizados ali, por enquanto apenas assuma que isso é o default a ser feito)
Note que criamos os outlets com o tipo dos controles da nossa view. É desta forma que teremos uma referência para os objetos da view e poderemos manipulá-los.
Vamos mudar nosso ViewController.m, criando as duas propriedades (lembrando que o .h contém apenas a interface).
Devemos alterar o ViewController da seguinte forma:
1 #import "ViewController.h"
2
3 @interface ViewController ()
4
5 @end
6
7 @implementation ViewController
8
9 @synthesize name;
10 @synthesize showName;
Repare que até a linha 7 não fizemos nada. O que fizemos foi adicionar as linhas 9 e 10. Isso é basicamente um gerador de getter e setter para as variáveis de instância que declaramos no .h
Vamos agora mudar o método showMessage para que ele manipule o input e o label:
1 -(IBAction)showMessage:(id)sender{
2 showName.text = [[NSString alloc] initWithFormat:@"Hello %@", name.text];
3 }
Bem simples né? O que estamos fazendo agora é dizendo que a propriedade text do nosso outlet showName é uma string formada por Hello + propriedade text do nosso outlet name.
Conectando os outlets
Está quase tudo pronto, agora só precisamos conectar os outlets aos nossos controles.
Uma outra forma de fazer essa conexão é também pressionando a tecla ctrl mas ao invés de arrastar para o File's Owner, podemos arrastar direto para a declaração do outlet:
(neste caso repare que cliquei no botão no canto superior direito da imagem, na seção editor, o botão do meio - Show the Assistant Editor)
Ou se preferir faça como fizemos da primeira vez (veja aqui).
Com isso quando executarmos nossa app, preencher o texto e clicarmos no botão teremos isso:
Resumo
Estamos avançando um pouco mais no entendimento de alguns conceitos do iOS. Agora já sabemos como manipular controles e exibir dados nas nossas views.
Se você quiser saber mais sobre os padrões de comunicaçào, delegates, outlets, actions, etc veja aqui: Cocoa Fundamentals
Para dar uma lida nos design patterns usados pelo cocoa veja aqui: Cocoa Design Patterns
Bom acho que por hoje é isso. O código dessas alterações já está no github: https://github.com/vquaiato/ios-blog-samples/tree/master/HelloWorldEvolution
Abraços, e até a próxima.
Vinicius Quaiato.
