Donde <nombre_dialogo> es aquel con el que usted se referirá al mismo, y <nombre_tabla> es el nombre de una tabla de diálogo que usted tendrá que declarar más adelante y en la que diseñará su aspecto, dimensiones y contenido (posición de los botones, botones de radio,... etc).

Nota: Se puede, y de hecho es recomendable, usar el mismo nombre para el nombre del diálogo y para la tabla, para evitar posteriores confusiones.

A continuación tiene una explicación de la función de los tres parámetros disponibles, tenga en cuenta que el parámetro -m es obligatorio y sin él no se creará nuestra ventana de dialogo:

-m: Es el parámetro que usará normalmente, sirve para crear una ventana de diálogo sin ningún atributo, es decir que todos los atributos (título, tamaño...) serán especificados en la tabla del diálogo.

Ejemplo: 

    /dialog –m midialogo mitabla

-ma: Crea una ventana de diálogo sin atributos (como la anterior) pero además usa la ventana activa como “madre”, es decir que al cerrar la “ventana madre” se cerrará también la que hemos creado.

Ejemplo:

    /dialog –ma midialogo mitabla

-md: Crea un diálogo sin atributos (puesto que lleva el parámetro -m) y lo abre como ventana de escritorio (será mostrada en la barra de tareas inferior de Windows). 

Ejemplo:

    /dialog –md midialogo mitabla

Una vez creado, podemos volver a usar el comando /dialog, pero esta vez para cambiar alguna de sus propiedades, y con la sintaxis:

    /dialog [-tsonkc] <nombre_dialogo> [atributos]

Y dependiendo del parámetro que especifique en [-tsonkc], usaremos unos atributos u otros (o a veces ninguno):

-x: Cierra una ventana de diálogo.

Ejemplo:

-t: Cambia el título de una ventana de diálogo.

Ejemplo:

-s: Cambia el tamaño y la posición del diálogo en base a las coordenadas y dimensiones que se especifiquen:.

Ejemplo:

    /dialog –s midialogo 10 20 300 400

Nota: Recuerde la definición de “rectángulo” en el tutorial de ventanas de imagen, el ejemplo de arriba pondrá la esquina superior izquierda del diálogo en las coordenadas x(10) y(20) y le dará un tamaño de 300 pixels de largo por 400 de alto.

–o: Pone el diálogo encima de todas las ventanas que tenga abiertas (on top), y sigue estando encima aunque pulse fuera de ella.

Ejemplo:

-n: Quita el atributo “on top” de un dialogo, es decir que ya no estará permanentemente encima de todas las ventanas.

Ejemplo: 

    /dialog –n midialogo

-k: Provoca el efecto de pulsar el botón “ok” de un diálogo. Por defecto, el efecto de este botón es simplemente el de cerrar el dialogo, pero más adelante veremos que le podrá asignarle más funciones.

Ejemplo:

-c: Provoca el efecto de pulsar en un botón “cancelar” de un diálogo, que por defecto es exactamente el mismo que el de un botón “ok”, pero al igual que en el anterior, se podrá modificar.

Ejemplo:

    /dialog –c midialogo

Vista la creación de ventanas de diálogo, ahora el tema será como crear las ya nombradas “Tablas de diálogo

TABLAS DE DIÁLOGO  

Como hemos visto anteriormente en la creación de diálogos, es necesario especificar el nombre de una tabla en la que definiremos el título, tamaño y objetos que habrá en el mismo. En está sección usted aprenderá a crear tablas de diálogo revisando todas las posibilidades que nos ofrece el mIRC. La declaración de tablas de dialogo se hace en la sección Remotes, y de la siguiente forma:

            DIALOG <nombre_tabla> {

..........

}

      Dialog mitabla {

title “Aquí el título”

size <x y w h>

button “Texto_del_botón”,<ID>,<x y w h>,<estilo>

}

Donde dice x y w h recuerde que ha de poner las coordenadas que definen el rectángulo al que se refiere: posición de la esquina superior izquierda del dialogo (x,y), longitud (w) y altitud (h) en pixels. Donde dice “ID” se refiere a un número que asignaremos a cada objeto que añadamos a la tabla, ese número nos servirá más adelante para referirnos a ese objeto, por lo tanto no se puede repetir la misma ID en dos objetos dentro de una misma tabla. Y por último el estilo, al tratarse de un botón, en este caso será uno de los siguientes:

Antes de entrar en el resto de objetos que podrá usar, veamos este pequeño ejemplo para que vaya entendiendo el funcionamiento de las tablas, copie lo siguiente en Aliases:

    /Dialogo { dialog –m midialogo mitabla }

Copie esto otro en Remotes:

    dialog mitabla {

    title "Hola Mundo!!"

    size 20 20 120 100

    button "¡¡Adiós!!",1,20 20 80 50,ok

    }

Si ahora escribe el alias (que puede ser mediante un popups o escribiéndolo en la línea de comandos) que acaba de crear: "/dialogo", verá como le aparece una ventana con el título que ha especificado y con un botón de tipo “ok” (cierra el dialogo al pulsarlo) , las coordenadas y tamaño de la misma serán: “20 20 100 100”.

A continuación veremos ya la relación de objetos que podemos declarar en una ventana de dialogo:

title “Título”

Como hemos visto en el ejemplo anterior, el texto que pongamos entre “ “ será el texto que salga en la barra de título del dialogo.

size x y w h

Indica la posición y tamaño del diálogo. Si indicamos el valor ‘-1’ para x e y, el diálogo aparecerá centrado en la pantalla.

text “Texto”,ID,x y w h,estilo

Pon el texto que indiquemos en las coordenadas x y w h. Recuerde que a cada objeto que ponga en el diálogo le ha de asignar un número ID, el que usted

edit “Texto inicial”,ID,x y w h,estilo

Inserta una caja de texto en el lugar indicado, con una posición y tamaño dados en “x y w h”, y con uno de los estilos siguientes:

<en_blanco> : si no especifica ningún estilo: campo de texto normal con el texto inicial alineado a la izquierda.

button “Texto del botón”,ID,x y w h,tipo

Crea un botón en cuyo interior ponga el texto que especifiquemos, y lo posiciona en las coordinadas x,y con un tamaño de ‘w’ pixels de largo por ‘h’ de alto. Los tipos posibles son:

check “Texto”,ID,x y w h,estilo

Crea un botón “checkbox” o botones de selección de opciones (sirven principalmente para activar/desactivar algo) en las coordenadas y con el texto especificado. Los estilos posibles son:

radio “Texto”,ID,x y w h,estilo

Crea un botón de radio (sirven para elegir entre una entre varias opciones) en las coordinadas “x y w h” y con el texto “Texto”. Los estilos posibles son:

box “Titulo”,ID,x y w h

Crea un rectángulo con el titulo, posición y tamaño especificados, se suele usar para enmarcar grupos de objetos, por ejemplo grupos de botones de radio.

list ID,x y w h,estilo

Crea una lista de objetos en las coordinadas especificadas (siempre relativas a la ventana de diálogo) en la que se podrán elegir uno o más objetos a la vez de la lista dependiendo del estilo. El cómo añadir mas objetos a la lista lo veremos más adelante. Los estilos posibles son:

<en_blanco>: si no especificamos estilo, se crea una lista en la que solo podemos seleccionar un objeto a la vez y el órden de estos será el mismo en que los añadamos mas adelante.

combo ID,x y w h,estilo

Crea una lista de objetos en la que solo se podrá elegir uno de ellos, en las coordenadas especificadas. Los estilos posibles son:

icon ID,x y w h,[archivo]

Inserta una imagen en formato .bmp en las coordenadas que indiquemos. Si los valores ‘w’ y ‘h’ no coinciden con el tamaño de la imagen, ésta será estrechada o ensanchada al tamaño que hayamos especificado, el parámetro archivo no hace falta especificarlo ahora, lo podrá hacer más adelante.

Hasta aquí todos los objetos que puede poner en un diálogo. Adicionalmente a los estilos que se han comentado, cualquier objeto puede además contar con los siguientes:

Una cosa importante que debe saber es que se pueden especificar VARIOS estilos a la vez con solo ponerlos separados con comas, por ejemplo:

    edit “Texto”,4,10 10 100 20,autohs,right

Nota: En la declaración de objetos puede usar variables, es decir podrá, por ejemplo, mostrar en un campo de texto el valor de una variable.

Ya hemos visto todos los tipos de objetos que podrá usar a la hora de crear una tabla de diálogo, por supuesto no usará todos estos tipos en el mismo diálogo, aunque podría hacerlo si quisiera... antes de seguir vamos a hacer un ejemplo de una ventana algo más complicada ya que con lo que sabemos hasta ahora es posible crear la interfaz gráfica de cualquier ventana de diálogo imaginable, lo próximo será proporcionar función habilidad a cada uno de los objetos... pero antes, lo dicho, vamos a un ejemplo: Copie lo siguiente en Aliases:

 /Dialogo2 { dialog –m dialogo2 mitabla2 }

Y ahora copie lo siguiente en Remotes:

    dialog mitabla2 {

    title "Qué información se muestra dónde"

    size 30 30 330 260

    box "Mostrar información",1,10 10 150 100

    radio "En Status",2,20 30 130 20,right,group

    radio "En Ventana aparte",4,20 80 130 20,right

    box "Otras opciones",5,170 10 150 100

    check "Mostrar Nombre",6,180 30 130 20,push

    check "Mostrar E-Mail",7,180 55 130 20,push

    check "Mostrar Web",8,180 80 130 20,push

    box "Datos",9,10 115 310 100

    text "Su Nombre:",10,20 135 100 20

    text "Su E-Mail:",11,20 160 100 20

    text "Su Web:",12,20 185 100 20

    edit "",13,100 135 180 20

    edit "",14,100 160 180 20

    edit "",15,100 185 180 20

button "Mostrar Información",16,40 225 130 25,ok

button "Cancelar",17,190 225 90 25,cancel

}

No se va a comentar el código línea por línea puesto que sería repetir lo ya explicado, pero una vez leído y probado (usando el alias "/dialogo2") se debe haber dado cuenta de unas cosas importantes:

El identificador $dialog  

Este identificador puede ser usado de varias maneras. Si en una tabla de un diálogo especificamos en unos de los objetos el estilo"result", y después creamos un diálogo usando este identificador, el valor que nos devolverá el identificador será el mismo que el de ese objeto cuyo estilo es "result". Para crear un diálogo con este identificador usaremos la sintaxis:

$dialog(<nombre_dialogo>,<nombre_tabla>)

Pero por supuesto siendo un identificador no puede usarse independientemente (como si fuera un comando) puesto que devuelve un valor que debemos de recoger, lo tendremos que utilizar para darle un valor a una variable, por ejemplo:  %resultado = $dialog(midialogo,mitabla).

También podemos usar este identificador sencillamente para obtener el nombre de los diálogos abiertos en este momento, para ello usaremos la sintaxis:

$dialog(<nombre_dialogo>/<N>)

Devolverá el número de diálogo en caso de que especifiquemos un nombre, o el nombre del diálogo abierto número <N> en caso de que optemos por especificar ese parámetro. Ejemplo: %variable = $dialog(3)

Le da a %variable el valor del nombre del tercer diálogo que tengamos abierto en ese momento.

Y el último uso del identificador $dialog es para recoger información general de un diálogo, como su tamaño o su título: