Usuario:ManuelRomero/Android/PrimerosContactos/EjemploCajasDialogo

=Preparar la apalicación=
 * Vamos a realizar una app, en la que vamos a usar la forma recomendada para abrir la ventanas de diálogo
 * Para realizar este tipo de acciones tenemos dos opciones. Una de ellas ya está depreciate y se recomienda usar fragment
 * En este caso lo vamos a hacer con fragment, concretamente heredando de la clase DialogFragment. Al final de este tema pondré el código de como hacerlo de la otra manera que en principio es más sencilla, pero menos flexible.

La clase diálogo
Nuestra aplicación va a constar de dos clases
 * 1) la activity que va a ser nuestra pantalla con los botones
 * 2) La ventana diálogo que en función del botón que presionemos visualizará una ventana de diálogo u otra

La clase VentanaDialogo solo un botón

 * La clase VentanaDialogo va a ser un Fragment especializado DialogFrament
 * Como todo Fragment a la hora de ser ejecutado dependera de una Activity que inicia su ciclo de vida
 * Los métodos callback que se ejecutan cuando se inicia el DialogFragment son onCreateDialog y onCreateView
 * Si vamos a usar una clase ya existen (AlerteDialog, ...), se escribe el código en onCreateDialog, sin embargo si fuéramos a realizar una caja de diálogo personalizada donde tuviéramos que definirnos un layout, podríamos sobreescribir el callback onCreteView.
 * Escribamos el código para visualizar una caja de diálogo ya establecida AlertDialog
 * En el cuerpo creamos un objeto de la clase AlertDialog, que explicamos en la siguiente sección, pero como vemos en la imagen es una clase que extiende de Dialog
 * Este médoto devuelve un objeto de la clase Dialog que nos retorna el método create de nuestro AlertDialog creado con AlertDialog.Builder


 * Veamos el código de setPositiveButton(...)
 * Los paŕametros
 * 1) texto es un CharSequence que establecerça el texto del botón
 * 2) lisener es un objeto listener que escuchará el objeto evento generado, cuando hagamos un click en el botón.
 * Este listener es una implementación de la interfaz DialogInterface
 * Para crear una instancia de la implementación de la interfaz lo hacemos invocando al método OnClickListnener
 * Como implementamos la interfaz debemos sobreescribier su método onClick
 * El método onClickrecibe dos parámetros:
 * 1) El objeto Dialog  que ha generado el evento.
 * 2) un entero que identifica el botón que ha generado el evento (útil si puedo tener varios botones como en el caso de un ratio o un check, que veremos posteriormente).
 * El cuerpo del bucle''
 * Lo que hacemos es invocar al método opcionSI que está en la clase Dialogo (la otra de nuestro ejemplo).
 * Como estamos en un Fragment, éste para entrar en ejecución depende de una Activity que la ha invocado, siempre podemos acceder a dicha Activity con el método getActivity de la clase Fragment correspondiente.
 * No olvidemos que un DialogFragment es un Fragment.
 * Siempre Hemos de hacer un cast al tipo concreto de Activity que vamos a obtener con el método getActivity en este caso nuestro Dialogo

AlertDialog
objeto.propiedad1 .propiedad2 ....     .propiedadn;
 * Es una clase que hereda de Dialog y tiene ya un layout establecido la cual se adapta visualmente en fución de que asignemos valores a propidades de la clase
 * Una vez creado el objeto le damos las propiedades que necesarias
 * Los métodos que asignas propiedades son muy intuitivos, y permiten asignar
 * 1) Un título setTitle
 * 2) Un mensaje de texto
 * Uno, dos o tres botones
 * 1) Una lista de items seleccionables, opcionalmente con casilla de verificación (puedo seleccionar varios-checkButtons) u opciones excluyentes (radio buttons).
 * 2) El método setCancelable(boolean) convierte la ventana de dialogo en modal respecto al botón de retroceso
 * Observar que para dar las diferentes propiedades puedo hacerlo seguido
 * De igual forma que hemos visto los métodos anteriores tenemos disponibles otras opciones

Añadiendo mas botones
En concreto vamos a hacer una app que nos visualice hasta 9 cajas de diálogo diferentes según vamos a ir viendo. A continuación vamos a ver como abordamos cada una de las cuestiones anteriores
 * Vamos a preparar nuestra aplicación para visualcizar diferentes cajas de diálogo.
 * Queremos tener en la clase Dialogo (Recordemos que es nuestra Activity), una interfaz con tantos botones como cajas de diálogo diferentes queremos que nos visualice nuestra app.
 * La dinámica de nuestra aplicación va a ser la siguiente:
 * 1) Al arrancar la app se visualizará la interfaz de la Activity Dialogo (imagen anterior).
 * 2) Presionaremos un botón.
 * 3) Creamos un objeto de la clase VentanaDialogo
 * 4) En función del botón presionado se preparará la caja de diálogo con una u otra información.
 * 5) Se visualizará la caja de diálogo donde podremos botones y/o opciones para seleccionar.
 * 6) Una vez tomada una opción de la ventana de diálogo haremos algo que visualice la opción tomada, o simplemente visualizaremos el diálogo como en el caso de barra de progreso
 * La siguiente imagen intenta ilustrar con un sencillo diagrama de transición la relación entre las clases

Pasando información entre las clases

 * Primero vemos cómo asociar los valores a la clase
 * A continuación como leer los valores desde la clase
 * Poniendo los valores
 * El primero paso es crear un objeto de la clase VentanaDialogo y de alguna forma le hemos de pasar información para que sepa ese objeto qué botón de los 10 que tenemos lo ha creado.
 * Para ello podríamos usar un constructor, pero en android cuando una activity u otro tipo de app javase carga en la pila de ejecución tiene un ciclo de vida. Esto hace que el método callback onCreate u otro que sepamos que se ejecuta cuando se crea el objeto de la clase realice todo lo que queremos que ocurra cuando se instancia un objeto de la clase. Por este mot aivo no se suelen usar constructores en android, aunque sí que se podría. Pero no sería el primer método que se ejecutaría al instanciar el objeto de la clase.
 * Para pasar parámetros entre clases en android podemos usar un método estático en la clase a la que queremos pasar parámetros
 * En nuestro caso en la clase VentanaDialogo.
 * Será un método estático para que lo pueda invocar antes de crear el objeto
 * Este mismo método me generará un objeto de la clase y me lo retornará
 * Dentro de él crearemos un objeto de la clase Bundle (ver sección siguiente), y le pasamos los parámetros
 * En nuestro caso queremos pasar dos valores
 * tipo es entero que representará el botón que hemos presionado usaremos la lista expuesta a continuación
 * título es un String que va a ser el título de la caja de diálogo (todas las cajas de diálogo tendrán un título
 * Ahora queda poner los valores, lo debe de hacer la clase Dialogo cuando declara un objeto de la clase VentanaDialogo, veámoslo en el código
 * Leyendo los valores
 * Ahora en la clase VentanaDialogo debemos leer estos valores
 * Ello lo haremos dentro del método de Callback que se ejecuta cuando el objeto entra en ejecución en este caso en onCreateDialog(...)
 * Para ello usamos el método Bundle getArgument de la clase Fragment que retorna los argumentos que se pasan a un Fragement cuando este ha sido instanciado con ellos. Nos retorna un Bundle
 * Posteriormente usaremos los métodos getxxx(etiqueta, valor), complementarios a los setxxx(etiquet, valor) usados para pasar los valores
 * como se puede ver en el código se puede hacer en una línea.
 * De esta forma ya tenemos el tipo de botón que ha presionado la acción, ahora discretizamos con un switch

Clase Bundle

 * Esta clase va a permitir pasar datos entre diferentes activity y/o Framgment
 * Esta clase implementa la interfaz Parcelable y Ser
 * La forma de hacerlo es la siguiente:
 * 1) Creamos un objeto de la clase Bundle
 * 2) Usando los métodos putxxx(etiqueta, valor), vamos preparando parejas etiqueta-valor para pasar a un objeto activity o fragment
 * 3) No vamos a poder pasar objetos complejos, sí tipo privitivos.
 * 4) Una vez que hayamos terminado de confeccionar todas las parejas etiqueta-valor con los métodos putxxx, asociamos el Bundle a clase Activity o Fragment que le queremos asociar el valor, con el método setArguments(Bundle) de la clase Activity o Fragment.
 * 5) Y ya está, luego en la clase podremos recuperar estos valores.

Opciones de tipo ratio

 * Tenemos diferentes opciones y queremos seleccionar solo una
 * En este caso usaremos el método setSingleChoiceItems(charSequence[] lista,int item_seleccionado,listener)
 * Observamos el botón correspondiente para esta accion
 * El código siguiente visualiza como adaptar un AlertDialog a este tipo de opciones


 * El método opcionRatio(String opcion) es un método de la clase Dialogo al que pasamos la opcion seleccionada
 * En nuestro caso lo único que hace es visualizar la opción

checkButton como opciones

 * Tenemos diferentes opciones y queremos seleccionar algunas de ellas
 * En ella el usuario debe checkear distintas opciones (seleccionar idiomas)
 * En este caso debemos invocar al método setMultiChoiceItems
 * Este método le pasamos el vector de opciones, un vector de boolenos que nos dice cada opción si está o no seleccionada y un listener.


 * En este caso al método setMultiChoiceItems(...) le pasamos tres parámetros
 * 1) idiomas que es el vector de opciones que queremos visualizar
 * 2) idiomasSeleccionados es un vector de booleanos que muestra si cada opción está o no seleccionada
 * 3) Una instancia de una clase listener para escuchar los objetos eventos generados por cualquier botón de las opciones
 * De nuevo invocamos a un método de la clase Dialogo '''opcionCheck(...), al que pasamos el vector de idiomas y el de booneanos.
 * El cuerpo del bucle quedaría

Ficheros con lo visto hasta ahora

 * Se pueden descargar los ficheros de lo hecho hasta ahora
 * 1) La clase Dialogo.java Archivo:Dialogo.pdf
 * 2) La clase VentanaDialogo.java Archivo:VentanaDialogo.pdf

Barra de progreso horizontal

 * Ahora le diremos que el objeto que tiene la forma horizontal de línea
 * En este caso tenemos una barra que se va rellenando
 * Esto implica que el progreso tendrá un valor inicial e irá modificando hasta llegar a estar totalmente rellena
 * Vamos a añadir un botón para cancelar