4workshop

CAPÍTULO IV: RESOURCE WORKSHOP
CAPÍTULO IV: RESOURCE WORKSHOP
1. CONCEPTOS BÁSICOS
Para la creación de las Ventanas de Resultados descritas en el capítulo anterior, se han dibujado, de
manera previa, estas ventanas y sus controles con el editor y compilador de recursos gráficos
Resource Workshop.
Un recurso es un aspecto visible de una aplicación, como es el menú, cuadros de diálogo, iconos,
cursores, bitmap... Casi todas las aplicaciones Windows tienen este tipo de recursos, por lo que esta
herramienta se convierte en una de las más importantes y útiles para el desarrollo de programas
Windows. Al no formar parte del código de la aplicación, se pueden crear a la vez que éste, y se
pueden modificar sin necesidad de acceder al código fuente del programa.
Los cuadros de diálogo que necesitamos dibujar en nuestra aplicación son: la Ventana de
Resultados Finales y la Ventana de Resultados Detallados, con sus controles correspondientes.
Pero definamos primero algunos conceptos que se usarán a lo largo del proyecto, antes de pasar a
explicar cómo se crean dichas ventanas
Un cuadro de diálogo TDialog es una ventana que comunica al usuario con la aplicación, le
proporciona información y le permite introducir datos o seleccionar diversas opciones.
Habitualmente los diálogos contienen controles, que son simplemente ventanas especializadas. Los
controles que existen son: texto estático (TStatic), editor de texto (TEdit), grupo (TGroupBox),
lista (TListBox), caja combinada (TComboBox), casilla de verificación (TCheckBox), botón de
radio (TRadioButton), barra de desplazamiento (TScrollBar) y botón (TButton). Pero los que nos
interesan y que usamos en nuestra aplicación los definimos a continuación:
46
CAPÍTULO IV: RESOURCE WORKSHOP

Un editor de texto TEdit es una caja cuya principal misión es la de introducir texto desde
teclado y mostrarlo en pantalla. Existe la posibilidad de que sea de sólo lectura, en cuyo
caso muestra una cadena de caracteres que hemos introducido desde el programa.

Los botones TButton se emplean para realizar tareas cada vez que son pulsados.

Un texto estático TStatic es una caja que sirve para mostrar una cadena de caracteres, que
no es modificable por el usuario, pero sí por el programa al ejecutarse.

Y las casillas de verificación o TCheckBox son cajas con dos estados (<<checked>> o
<<unchecked>>), para seleccionar o señalar diversas opciones entre un conjunto.
A continuación explicaremos cómo se han dibujado las dos ventanas mencionadas con el editor de
recursos gráficos.
2. VENTANA DE RESULTADOS FINALES
Este es un cuadro de diálogo que consta de:

Una columna de 7 botones con el nombre de las tipologías de estilo y los índices de
Gunning y Flesh.

Una columna de 8 editores de texto de sólo lectura, en la que se muestra el grado de
aceptabilidad de cada una de las tipologías e índices, y la puntuación que se corresponde
con cada escala, así como la puntuación del estilo global.

Un botón de OK que finaliza la aplicación.
Para dibujar en el Resource Workshop esta ventana y todos sus controles, primero se crea el cuadro
mediante Resorce|New|Dialog del menú. Esto crea una ventana estándar que podremos
modificar:

Cambiamos su tamaño según nos interese.

Modificamos el identificador que se le asigna por defecto, por uno más significativo
(MUESTRADLG).

La ventana se crea con tres botones (OK, CANCEL, HELP), de los cuales sólo nos
interesa el de OK, con identificador IDOK, para cerrar la ventana. De manera que
suprimimos los otros dos.

Ponemos a la ventana el título de "RESULTADOS", que es lo que el usuario ve en la parte
superior del cuadro cuando éste aparece.
47
CAPÍTULO IV: RESOURCE WORKSHOP
A continuación añadimos los 7 botones, seleccionando Dialog|Insert New Control|Push
Button. Podemos también modificar sus propiedades:

Editamos el texto que queremos que muestren los botones: "GunningAyuda",
"FleshAyuda",
"DirectoAyuda",
"ClaroAyuda",
"ConcisoAyuda",
"AccionAyuda",
"VariadoAyuda".

Cambiamos los identificadores. Por regla general, los identificadores de los controles de un
cuadro de diálogo comienzan por el prefijo general ID_. El identificador será un nombre
que sirve de enlace entre el código y los recursos. El código fuente maneja los recursos por
medio de los identificadores, por lo que conviene poner nombres significativos. Por
defecto aparecen: IDC_BUTTON1, IDC_BUTTON2, ... , IDC_BUTTON14, pero los
modificamos
por:
IDC_GUNNING_AYUDA,
IDC_FLESH_AYUDA,
IDC_DIRECTO, IDC_CLARO, IDC_CONCISO, IDC_ACCION, IDC_VARIADO.
Y por último, creamos los 8 editores de texto, seleccionando Dialog|Insert
New
Control|Text Edit, y cambiamos sus características:

Escribimos el texto que queremos que muestre el control, por defecto. En realidad, no es
necesario poner nada, porque es el programa, al ejecutarse, el que va a modificar esto,
mostrando el grado de aceptabilidad de las tipologías e índices.

Los
identificadores
de
los
8
TEdit
son:
IDC_GUNNING,
IDC_FLESH,
IDC_DIRECTO, IDC_CLARO, IDC_CONCISO, IDC_ACCION, IDC_VARIADO.

Es importante seleccionar como característica que el editor de texto sea de sólo lectura
(Read Only). Esto se hace así porque sólo queremos que aparezca una cadena de caracteres
por pantalla, y no que el usuario escriba ningún dato.
Así, ya estaría dibujado el cuadro de diálogo MuestraDlg o Ventana de Resultados Finales.
3. VENTANA DE RESULTADOS DETALLADOS
La Ventana de Resultados Detallados está formado por los siguientes controles:

Un texto estático para mostrar el nombre de la tipología que hemos elegido.
48
CAPÍTULO IV: RESOURCE WORKSHOP

Una columna de 14 textos estáticos donde aparecen los elementos lingüísticos que se han
analizado en esta tipología.

Una columna de 14 botones de ayuda para cada uno de los elementos.

Un texto estático con el siguiente título: "Ocurrencias en el texto (%)".

Una columna de 14 textos estáticos que muestran las ocurrencias o apariciones en el texto
(en tanto por ciento) de cada elemento.

Un texto estático que muestra la siguiente cadena de caracteres: "Frecuencias
recomendadas (%)".

Una columna de 14 TStatic con las ocurrencias recomendadas.

Una columna de 14 casillas de verificación o checkboxes que aparecen marcadas si la
frecuencia de aparición obtenida está dentro de los límites de la recomendada.

Un botón de ayuda cuyo texto es: "Escalas de aceptabilidad".

Y por último, un botón de OK que cierra este cuadro de diálogo.
Para dibujar esto, primero creamos el cuadro mediante Resource|New|Dialog y cambiamos sus
propiedades:

Modificamos el tamaño del cuadro.

Asignamos el identificador IDD_TIPOLOGIAS.

De los 3 botones que se crean automáticamente (OK, CANCEL, HELP), sólo
mantenemos el de OK (con identificador ID_OK), cuya función será la de cerrar la
ventana.

Ponemos el título de "TIPOLOGÍAS", que aparece en la parte superior del cuadro.
Añadimos el texto estático que muestra el nombre de la tipología que hemos escogido, mediante
Dialog|Insert New Control|Static Text:

Ponemos, por defecto, un texto que queramos que aparezca en el control. Esto no es
necesario porque es el programa el que se encarga de escribir aquí el nombre de la tipología
elegida.

Asignamos un identificador (IDC_STATICTEXT0) para poder manejar este control desde
el código fuente.
A continuación dibujamos los 14 textos estáticos donde aparecen los elementos lingüísticos que
afectan a la tipología:
49
CAPÍTULO IV: RESOURCE WORKSHOP

El texto de estos controles también se actualiza en el momento de la ejecución del
programa, así que ponemos uno por defecto o ninguno.

Los identificadores serán: IDC_STATIC1, IDC_STATIC2, ... , IDC_STATIC14.
Los botones de ayuda se dibujan mediante Dialog|Insert New Control|PushButton:

El texto que ponemos en todos ellos es "Ayuda".

Y los identificadores asignados son: ID_HELP1, ID_HELP2, ... , ID_HELP14.
Hay dos TStatic cuyo texto es igual en todas las ventanas independientemente de la tipología. Uno
de ellos es:

el que muestra la cadena de caracteres: "Ocurrencias en el texto (%)"

y tiene identificador IDC_OCURRENCIAS.
Y el otro:

tiene el siguiente texto: "Frecuencias recomendadas (%)"

y el siguiente identificador: IDC_FREC_RECOMEND.
Seguidamente añadimos los 14 TStatic en los que aparecen las ocurrencias (en tanto por ciento) de
cada elemento:

El texto es modificado en el programa.

Los identificadores son: IDC_OCURRENCIAS1, IDC_OCURRENCIAS2, ... ,
IDC_OCURRENCIAS14.
Y a continuación, aquellos que muestran las frecuencias recomendadas:

De nuevo, el texto se actualiza al ejecutarse la aplicación.

Y
los
identificadores
son:
IDC_RECOMEND1,
IDC_RECOMEND2,
...
,
IDC_RECOMEND14.
Existen otros controles, que son las casillas de verificación que creamos mediante
Dialog|Insert New Control|CheckBox:
50
CAPÍTULO IV: RESOURCE WORKSHOP

En estos no ponemos ningún texto. El programa se encarga de marcarlo o dejarlo sin
marcar según se cumplan o no unas condiciones.

Los identificadores de estos controles son: IDC_CHECKBOX1, IDC_CHECKBOX2, ... ,
IDC_CHECKBOX14.
Y por último, añadimos otro botón de ayuda:

que muestra el texto "Escalas de aceptabilidad"

y tiene como identificador ID_ACEPTABILIDAD.
Con esto, ya están creadas las 2 ventanas en el Resource Workshop. Ahora sólo queda relacionar
estas ventanas con el código fuente, y esto se hace mediante los identificadores que se han asignado
a cada uno de los controles, como iremos explicando en el capítulo V.
51
CAPÍTULO IV: RESOURCE WORKSHOP
CAPÍTULO IV: RESOURCE WORKSHOP ...........................................................................................46
1. CONCEPTOS BÁSICOS ....................................................................................................................46
2. VENTANA DE RESULTADOS FINALES ...................................................................................47
3. VENTANA DE RESULTADOS DETALLADOS .......................................................................48
52