Android Dialog: Caixas de di�logos no Android com AlertDialog

Uma caixa de di�logo � uma pequena janela que solicita ao usu�rio tomar uma decis�o ou inserir informaç�es adicionais. Um di�logo n�o preenche toda a tela e � normalmente utilizado para eventos modais, requerendo aos usu�rios uma interaç�o antes de prosseguir.

Um AlertDialog pode mostrar um t�tulo, at� tr�s bot�es, uma lista de itens selecion�veis ou n�o, ou um layout personalizado. Vamos ver ao decorrer deste artigo todas essas opç�es.

Saiba mais: Curso de Android

Di�logo b�sico: Exibindo Caixas de Di�logo no Android

Figura 1. Exemplo de um di�logo b�sico

No exemplo b�sico vamos criar um di�logo como a imagem acima, um t�tulo, mensagem e dois bot�es.

� importante sabermos que ao criarmos o di�logo utilizando os recursos padr�es ele ser� automaticamente desfeita ao pressionar qualquer dos bot�es.

A criaç�o � simples e em todos os exemplos vamos utilizar o mesmo recurso para a criaç�o do objeto AlertDialog. Utilizaremos a classe AlertDialog.Builder, vamos instanci�-la e configurar o que ser� exibido (t�tulo, mensagem, bot�es, etc...) ap�s isso vamos pegar o AlertDialog do Builder e mandar exibir o di�logo.


//atributo da classe.
private AlertDialog alerta;

private void exemplo_simples() {
    //Cria o gerador do AlertDialog
    AlertDialog.Builder builder = new AlertDialog.Builder(this);
    //define o titulo
    builder.setTitle("Titulo");
    //define a mensagem
    builder.setMessage("Qualifique este software");
    //define um bot�o como positivo
    builder.setPositiveButton("Positivo", new DialogInterface.OnClickListener() {
        public void onClick(DialogInterface arg0, int arg1) {
            Toast.makeText(MainActivity.this, "positivo=" + arg1, Toast.LENGTH_SHORT).show();
        }
    });
    //define um bot�o como negativo.
    builder.setNegativeButton("Negativo", new DialogInterface.OnClickListener() {
        public void onClick(DialogInterface arg0, int arg1) {
            Toast.makeText(MainActivity.this, "negativo=" + arg1, Toast.LENGTH_SHORT).show();
        }
    });
    //cria o AlertDialog
    alerta = builder.create();
    //Exibe
    alerta.show();
}

Listagem 1. Exemplo AlertDialog b�sico

Di�logo customizado

Figura 2. Exemplo de um di�logo customizado

Seguindo os passos da criaç�o de nosso di�logo b�sico, agora vamos criar um layout customizado, primeiramente ser� feita a construç�o do nosso arquivo XML chamado de "alerta.xml", nele vamos inserir um ImageView e um Button dentro de um LinearLayout.


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
              android:orientation="vertical"
              android:layout_width="fill_parent"
              android:layout_height="fill_parent"
>
    <ImageView
        android:layout_width="wrap_content" 
        android:layout_height="wrap_content" 
        android:layout_gravity="center"
        android:src="@drawable/imagem_teste"
/>
    <Button
        android:id="@+id/bt"  
        android:layout_width="fill_parent" 
        android:layout_height="wrap_content" 
        android:text="Dismiss"
/>
</LinearLayout>

Listagem 2. Arquivo alerta.xml utilizado no di�logo customizado

Agora vamos inserir esse layout no di�logo e tratar a aç�o do bot�o. Lembre-se que o AlertDialog est� como vari�vel da classe, assim como no primeiro exemplo.


private void exemplo_layout() {
    //LayoutInflater � utilizado para inflar nosso layout em uma view.
    //-pegamos nossa instancia da classe
    LayoutInflater li = getLayoutInflater();
    
    //inflamos o layout alerta.xml na view
    View view = li.inflate(R.layout.alerta, null);
    //definimos para o bot�o do layout um clickListener
    view.findViewById(R.id.bt).setOnClickListener(new View.OnClickListener() {
        public void onClick(View arg0) {
            //exibe um Toast informativo.
            Toast.makeText(MainActivity.this, "alerta.dismiss()", Toast.LENGTH_SHORT).show();
            //desfaz o alerta.
            alerta.dismiss();
        }
    });
    
    AlertDialog.Builder builder = new AlertDialog.Builder(this);
    builder.setTitle("Titulo");
    builder.setView(view);
    alerta = builder.create();
    alerta.show();
}

Listagem 3. Exemplo AlertDialog customizado

Di�logos de lista de seleç�o simples

Tamb�m com base nos exemplos anteriores, fazer uma lista nada mais � do que voc� definir um vetor de informaç�es e inseri-las no Builder do di�logo.

Figura 3. Di�logo de seleç�o simples

Neste exemplo foi utilizado um ListAdapte


<?xml version="1.0" encoding="utf-8"?>
<TextView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:textSize="20sp"
    android:textColor="#FF000000"
    android:padding="10sp"
/>

Listagem 4. Item que contem o TextView da lista

Como vimos, nosso item � s� um TextView, veja na listagem abaixo como construir o adaptador e inserir no AlertDialog.


private void exemplo_lista_single() {
    //Lista de itens
    ArrayList<String> itens = new ArrayList<String>();
    itens.add("Ruim");
    itens.add("Mediano");
    itens.add("Bom");
    itens.add("�timo");
    
    //adapter utilizando um layout customizado (TextView)
    ArrayAdapter adapter = new ArrayAdapter(this, R.layout.item_alerta, itens);

    AlertDialog.Builder builder = new AlertDialog.Builder(this);
    builder.setTitle("Qualifique este software:");
    //define o di�logo como uma lista, passa o adapter.
    builder.setSingleChoiceItems(adapter, 0, new DialogInterface.OnClickListener() {
        public void onClick(DialogInterface arg0, int arg1) {
            Toast.makeText(MainActivity.this, "posiç�o selecionada=" + arg1, Toast.LENGTH_SHORT).show();
            alerta.dismiss();
        }
    });

    alerta = builder.create();
    alerta.show();
}

Listagem 5. Implementaç�o do AlertDialog em lista

Saiba mais: Curso de Android

Di�logo de lista com v�rias seleç�es

Os itens da lista do di�logo de seleç�es m�ltiplas se resumem em um componente de texto e um CheckBox.

Figura 4. Di�logo de seleç�o m�ltipla

Neste exemplo, o que temos de diferente s�o dois vetores, um de CharSequence[] onde ser�o armazenados os textos, e um vetor de boolean[] onde ficar�o armazenadas as informaç�es de habilitado ou desabilitado de cada item. Por isso que � muito importante construir esse vetor de acordo com o tamanho do vetor do CharSequence[]. Na listagem abaixo ser� mostrado como implementar e utilizar essa lista.


private void exemplo_lista_multi() {
    CharSequence[] charSequences = new CharSequence[]{"Filmes", "Dormir","Sair"};
    final boolean[] checados = new boolean[charSequences.length];

    AlertDialog.Builder builder = new AlertDialog.Builder(this);
    builder.setTitle("O que voc� gosta?");
    builder.setMultiChoiceItems(charSequences, checados, new DialogInterface
    .OnMultiChoiceClickListener() {
        public void onClick(DialogInterface arg0, int arg1, boolean arg2) {
            checados[arg1] = arg2;
        }
    });

    builder.setPositiveButton("Confirmar", new DialogInterface.OnClickListener() {
        public void onClick(DialogInterface arg0, int arg1) {
            StringBuilder texto = new StringBuilder("Checados: ");
            for (boolean ch : checados) {
                texto.append(ch).append("; ");
            }
            Toast.makeText(MainActivity.this, texto.toString(), Toast.LENGTH_SHORT).show();
        }
    });

    alerta = builder.create();
    alerta.show();
}

Listagem 6. Implementaç�o do AlertDialog em lista

Observe que o listener do setMultiChoiceItems � diferente pois utilizamos a interface OnMultiChoiceClickListener() que nos retornara a posiç�o e o estado do bot�o.

Saiba mais: Android Developer

Conclus�o

O AlertDialog � uma classe essencial no desenvolvimento de aplicaç�es Android, permitindo ao usu�rio uma caixa simples para a seleç�o de opç�es.

Como todo componente do Android, o AlertDialog � totalmente customiz�vel, permitindo o uso de um layout personalizado, com seus pr�prios bot�es e informaç�es. Seu uso al�m de simples e vi�vel deve ser estudado para atender ao usu�rio. Lembre-se sempre de pesquisar na documentaç�o do Android como utilizar cada recurso da melhor maneira poss�vel.

Com isso finalizo esse artigo. Em anexo segue o projeto que foi utilizado como exemplo. At� o pr�ximo, um grande abraço e obrigado.

Refer�ncias: Developer Android, Dialogs: Acesse o site oficial

Links �teis

Minha primeira conex�o com FireDAC em Delphi: Aprenda a criar uma conex�o utilizando o FireDAC no Delphi, por meio do componente FDConnection . Para isso partiremos de um banco j� criado no MySQL.
Desenvolvendo aplicaç�es Windows Universal com a Bing API: Este artigo � �til para que o leitor seja capaz de desenvolver aplicativos que utilizem recursos de mapas, tais como: indicaç�o de rotas, marcaç�o de pontos, recuperaç�o de posiç�o atual, velocidade atual, entre outros, utilizando o Bing Maps API da Microsoft.
Como criar minha primeira classe em Python: Aprenda neste conte�do como criar sua primeira classe utilizando a linguagem de desenvolvimento Python.
Primeira aplicaç�o Web com Spring MVC e JPA: Neste curso, ser� demonstrado como realizar esta integraç�o em uma aplicaç�o web desenvolvida com o Spring MVC.

Saiba mais sobre Android ;)

Guia de Android: O Android � a plataforma oficial para desenvolvimento de aplicativos mobile do Google. Neste guia voc� encontrar� artigos, v�deos e cursos para aprender tudo sobre esse SDK, que domina o mundo dos dispositivos m�veis.
Navegaç�o entre telas no Android: Aprenda neste conte�do como � feita a navegaç�o entre activities (telas) no Android usando Java. Veremos como efetuar a navegaç�o com e sem passagem de par�metros.
Introduç�o ao Android: Este artigo traz uma introduç�o ao Android e as etapas necess�rias para iniciar o desenvolvimento de aplicativos para essa plataforma.

Android Dialog

Veja neste artigo como exibir uma caixa de dialogo para o usuário, em aplicações Android, usando a classe AlertDialog de várias maneiras possíveis.