Tipos de campos

Define la apariencia y tipo de información que podrá contener el campo.

Campos alfanuméricos

• Tipo : 'C'
• Pestaña: '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
• Etiqueta: Escoger el literal adecuado de la tabla de literales.
• Posición etiqueta:
  • ‘E’: Encima, en principio se tomará por defecto esta posición.
  • ‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
  • ‘N’: Sin etiqueta.
• Número de dígitos
• Pos.1: (x,y): Corresponde a la esquina superior izquierda de la caja.
• Pos.2: (x,y):
  • x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos i no quepan más letras, ellas solas correrán.
  • y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
• Contenido:
  • 'X': Alfanumérico.
  • 'C': Clave, se visualizan asteriscos.
• Signo: 0, no se utiliza
• Editado: 0, no se usa.

Campos numéricos

• Tipo : 'C'
• Pestaña: '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
• Etiqueta: Escoger el literal adecuado de la tabla de literales.
• Posición etiqueta:
  • ‘E’: Encima, en principio se tomará por defecto esta posición.
  • ‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
  • ‘N’: Sin etiqueta.
• Número de dígitos: sin contar comas, separadores de miles o signo.
• Pos.1: (x,y): Corresponde a la esquina superior izquierda de la caja.
• Pos.2: (x,y):
  • x: No se utiliza.
  • y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
• Contenido: '0' si no tiene decimales, si los tiene, el número de decimales.
• Signo: 0, no se utiliza
• Editado: 0, no se usa.

Campos fecha

Las fechas se muestran en el formato: dd/mm/aaaa. El usuario puede omitir las barras separadoras en la introducción así como los 2 dígitos del milenio. El programa cliente se encarga de formatear la entrada.

• Tipo : 'C'
• Pestaña: '0' si no pertenece a ninguna pestaña o el índice de la pestaña a que pertenece.
• Etiqueta: Escoger el literal adecuado de la tabla de literales.
• Posición etiqueta:
  • ‘E’: Encima, en principio se tomará por defecto esta posición.
  • ‘I’: A la izquierda, se utilizará cuando el campo sea pequeño, por ejemplo campos tipo S/N.
  • ‘N’: Sin etiqueta.
• Número de dígitos: No se utiliza. Se toman siempre diez dígitos.
• Pos.1: (x,y): Corresponde a la esquina superior izquierda de la caja.
• Pos.2: (x,y):
  • x: No se utiliza.
  • y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
• Contenido: 'F'
• Signo: 0, no se utiliza
• Editado: 0, no se usa.
• Valor def.: Aquí podemos poner una fecha por defecto para que aparezca en el campo. Si nos interesa que tengamos siempre la fecha actual en este campo, o primero de mes, podemos usar estos valores de entorno:
  • &$fecha: Fecha actual.
  • &$fecha1m: Fecha de primero de mes.
  • &$fecha1a: Fecha de primero de año.

Campo de texto

• Tipo: 'T'
• Etiqueta: Escoger el literal adecuado de la tabla de literales para que aparezca traducido al lenguaje del usuario. Si no es un código de literal, aparece directamente lo introducido aquí.
• Número de dígitos: se utiliza para calcular el tamaño del control, en caso de que no se haya introducido pos. 2.
• Pos.1: (x,y): esquina superior izquierda del cuadro
• Pos.2: (x,y):
  • x: Cuando se necesita crear un campo de una determinada extensión gráfica, pero que el número de dígitos es superior a esta, indicamos en la x de la posición 2 la coordenada final del campo gráfico, y automáticamente cuando escribamos y no quepan más letras, ellas solas correrán.
  • y: Si és 0, el campo se dibuja con altura por defecto de 18 pixels, si indicamos un valor, podemos ajustar la altura del campo. Si la altura supera los 24 pixeles la fuente del control es mayor.
• Posición etiqueta: Tamaño de la fuente, posibles valores:
  • 'P': Fuente pequeña
  • 'M': Fuente mediana
  • 'G': Fuente grande
  • 'F': Fuente de espaciado fijo.
  • 'L': Espaciado fijo, fuente grande
• Contenido: ‘X’ , no se utiliza
• Signo: 0, no se utiliza
• Editado: 0, no se usa
• Pasar el control al salir : 0, no se usa
• Orden de tabulación: en principio no se usa
• Pestaña: si pertenece a alguna pestaña, su número si no 0.

Botones

• Tipo: ‘B’
• Número de dígitos: Se tomará para dimensionar la anchura del botón.
• Pos.1: (x,y): esquina superior izquierda del botón
• Pos.2: (x,y):
  • x: Número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
  • y: No se utiliza.
• Etiqueta: Escoger el literal adecuado de la tabla de literales. Aparecerá dentro del botón.
• Pasar el control: 1.

Botones herramienta

• Tipo: ‘H’
• Contenido:
  • Si no se especifica nada, se utiliza para realizar cualquier acción que establezcamos mediante programación.
  • 'Y' Botón que muestra una página de ayuda, para más información ver el apartado Botón de ayuda.
  • 'I' Botón que arranca una nueva instancia de la aplicación con los mismos parámetros de conexión que la actual
  • 'T' Botón que abre un teclado virtual. Si no se ha especificado en el fichero de configuración del cliente, abrirá el teclado virtual por defecto que viene con Windows.
• Etiqueta: Escoger el literal adecuado de la tabla de literales. Aparecerá cuando el puntero del ratón pase por encima del control (tooltip).
• Posición etiqueta:
  • 'M': Tamaño medio, 24x24 pixels, valor por defecto
  • 'P': Tamaño pequeño, 17x17 pixels.
  • 'G': Tamaño grande, 30x30 pixels, apropiado para usarse en pantallas táctiles.
• Pos.2: (x,y):
  • x: número de tecla aceleradora asociada al botón: 1:F1, 2: F2, etc. Listado de teclas aceleradoras.
  • y: se utiliza parar indicar la imagen que será el número asignado en el fichero resource.h del proyecto dgp21i01.
• Pasar el control: 1.

Botón de ayuda o enlace al navegador

Se utiliza para acceder a la ayuda de la aplicación o bien enlazar con el navegador indicando una URL completa

Acceder a la ayuda.

Pulsando el botón de ayuda, mediante el ratón o pulsando F1, se accede a la pagina html de ayuda en la posición que corresponda. El prefijo para construir el path completo de la página de ayuda lo resuelve el programa cliente en función del fichero de configuración: puede apuntar a paginas en la intranet de la empresa, internet o páginas locales. Este prefijo se guarda en dgp21.cfg de la forma siguiente:

1. --- Path ajuda

ajuda=l:\libs\man\;

El path completo se obtiene añadiendo el código del idioma del usuario.

Por ejemplo, si el usuario ha escogido en la pantalla de conexión el código de idioma 'Fr', francés, las pantallas de ayuda se buscaran en:

l:\libs\man\Fr

Es un control tipo botón de ayuda con las siguientes particularidades:

• Tipo: 'H'
• Contenido: 'Y', ayuda.
• Valor por defecto: Dirección página web y marcador de situación en la página, por ejemplo:

control_presencia1.htm#CP

Si el control contiene una URL completa llama al navegador y abre la URL en cuestión.

Normas de estilo para las páginas de ayuda

Cuadro

Recuadro planos transparente o con un bitmap. Como recuadro transparente se usa para agrupar visualmente controles relacionados.

• Tipo: 'U'
• Contenido: 'B' para mostrar un bitmap, 'V' para mostrar barra de scroll vertical, 'S' o cualquier otro, para mostrar un recuadro transparente.
• Pos. Etiq.:
  • Si el contenido es 'B': 'S' para forzar que la imagen ocupe el espacio del recuadro, 'R' muestra la imagen a tamaño real, 'N' corta la imagen mostrando solo el espacio que ocupa el cuadro sin modificar la proporción.
  • Si el contenido es 'V': no tiene utilidad.
  • Si el contenido es 'S': 'S' para mostrar un titulo, 'N' para no hacerlo.
• Valor por defecto: Número de referencia del bitmap.
• Pos.1: Esquina superior izquierda del recuadro.
• Pos.2: Esquina inferior derecha.

Pantalla o ventana

Recuadro opaco y con relieve. Para visualizar una ventana superpuesta. Para aplicar el titulo a la ventana debe añadirse un control de tipo texto estático con fondo azul y letras blancas.

• Tipo: 'P'.
• Pos.1 (x,y): Esquina superior izquierda del recuadro.
• Pos.2 (x,y): Esquina inferior derecha.
• Tabulador: Si és distinto de cero significa que se quiere llamar la atención del usuario y por tanto se muestra la pantalla aunque en aquel momento la aplicación esté minimizada u oculta por otra aplicación.

Texto extenso

Controles tipo caja para albergar un texto extenso. Si el texto sobrepasa el área del control, aparece la barra de scroll vertical.

• Tipo: 'X'
• Contenido: 'M', Indicamos tipo de letra mediana, en cualquier otro caso letra por defecto.
• Número de dígitos: Longitud máxima del campo
• Pos.1 (x,y): Esquina superior izquierda del recuadro.
• Pos.2 (x,y): Esquina inferior derecha.

Menú

Tipo de campo utilizado en los menús.

• Tipo: 'M'.
• Contenido: irrelevante.
• Pos. 2: irrelevante, la anchura se fija en función del número de dígitos.
• Tipo de fuente: fijado por la aplicación.

Cabecera de listado

Se utiliza para la cabecera de un listado. Pinchando sobre cada columna se ordenan los datos mostrados. Pulsando sucesivamente en otra columna añade la anterior columna pulsada a la ordenación, así hasta 3 columnas.

• Tipo: 'S'
• Pos. 2: x: si se especifica, fija la longitud del campo, si no, se calcula en función del número de dígitos. La y es irrelevante, la altura es fija.

• Fuente:
  • 'F': Standard, espaciado proporcional.
  • 'S': Standard, espaciado fijo.
  • 'P': Pequeña, espaciado proporcional.
  • 'T': Pequeña, espaciado fijo.

• Atributo:
  • '8': Fondo de color oscuro, letras blancas.

• Editado:
  • '0': Sin lineas de separación.
  • '1': Con linea vertical de separación entre columnas.
  • '2': Con linea horizontal de base.

Línea de listado

Se utiliza para las líneas de listado. Pinchando sobre ellas se resaltan y suelen utilizarse para realizar alguna acción relacionada con la línea de datos.

• Tipo: 'I'
• Pos. 2: x: si se especifica, fija la longitud del campo, si no, se calcula en función del número de dígitos. La y es irrelevante, la altura es fija.

• Fuente:
  • 'F': Standard, espaciado proporcional.
  • 'S': Standard, espaciado fijo.
  • 'P': Pequeña, espaciado proporcional.
  • 'T': Pequeña, espaciado fijo.

• Atributo:
  • '2': Fondo de color.
  • '3': Fondo blanco.

• Editado:
  • '0': Sin lineas de separación.
  • '1': Con linea vertical de separación entre columnas.
  • '2': Con linea horizontal de base.

Campos tipo pestaña

Habrá que definir tantos controles de este tipo como pestañas distintas. Cada una de ellas tendrá un núm. de orden distinto empezando por 1. El tamaño del control lo tomará de la pestaña con núm. pestaña = 1. Para asignar los controles a las pestañas habrá que indicar en ellos el núm. de pestaña al que pertenecen. Si núm. Pestaña = 0 no pertenece a ninguna pestaña.

Limitación sólo es posible 1 pestaña por pantalla.

• Tipo: 'N'
• Etiqueta: nombre de la pestaña
• Pos.1: (x,y): esquina superior izquierda del cuadro
• Pos.2: (x,y): esquina inferior derecha, sólo se tiene en cuenta para la Pestaña = 1
• Posición etiqueta: poner ‘P’, de momento no se utiliza.
• Contenido: ‘X’ , no se utiliza
• Signo: 0, no se utiliza
• Número de dígitos: no se utiliza, el tamaño de la pestaña depende de su etiqueta.
• Editado: 0, no se usa
• Pasar el control al salir: 0, no se usa
• Orden de tabulación: en principio no se usa.
• Pestaña: Núm. De pestaña empezando por 1.

Campo tipo “Checkbox”

• Estado: campo que sólo permite 2 estados:
  • Chequeado
  • No chequeado.

• Tipo: 'K'
• Etiqueta: Nombre del campo
• Pos.1: (x,y): esquina superior izquierda del cuadro de chequeo
• Pos.2: (x,y): no se utiliza
• Posición etiqueta:
  • ‘I’: A la izquierda
  • ‘N’: Sin etiqueta
  • 'D': A la derecha
• Contenido:
  • ‘X’ : Si el campo está chequeado su valor es 'S', en caso contrario su valor es ' ' (un espacio)
  • 'B': Campo boleano estricto, si está chequeado su valor es 'S', en caso contrario es 'N'.
• Signo: 0, no se utiliza
• Número de dígitos: no se utiliza.
• Editado: 0, no se usa

Texto interactivo

Campo de texto que al clicar sobre él con el ratón cambia de color. Se utiliza para las líneas de una grid. Se juega con los atributos para darle un fondo de color y crear el listado con colores alternos para cada línea.

• Tipo: 'I'
• Etiqueta: No se usa
• Pos.1: (x,y): esquina superior izquierda del cuadro
• Pos.2: (x,y): No se usa.
• Posición etiqueta: Tamaño de la fuente, posibles valores:
  • 'P': Fuente pequeña
  • 'M': Fuente mediana
  • 'G': Fuente grande
  • 'F': Fuente de espaciado fijo.
• Contenido: ‘X’ , no se utiliza
• Signo: 0, no se utiliza
• Número de dígitos: se utiliza para calcular la longitud del control..
• Editado: 0, no se usa
• Pasar el control: al salir = 1
• Orden de tabulación: en principio no se usa.
• Pestaña: si pertenece a alguna pestaña, su número si no 0.
• Pertenencia: 'L' indica que pertenece a una grid.
• Enlazar control: Cuando la pantalla que contiene la “grid” tiene un área de detalle con los campos de la línea del listado, entonces enlaza con el control 36 que es el encargado de rellenar ese detalle a partir del oid correspondiente a la línea seleccionada.
• Nota: Este campo debe tener la función g_fijar que tiene como misión obtener el “oid” de la línea seleccionada.