Unidad v - 1 - Formularios en VFP (2013)

FORMULARIOS CON VISUAL FOXPRO

Los formularios sirven para ofrecer a los usuarios una interfaz familiar para ver e introducir datos en una base de datos.

También ofrecen un amplio conjunto de objetos que pueden responder a los eventos del usuario (o del sistema) permitiéndoles realizar las tareas de administración de información de la forma más sencilla e intuitiva posible.

Diseño de Formularios

miércoles, 05 de junio de 2013 Formularios con Visual Foxpro 2

Supongamos que tenemos un proyecto que se llama “prueba”.

1. En la ficha correspondiente a Documentos, encontramos el icono “Formularios”

2. Nuevo

3. Nuevo Formulario

El diseñador de formularios


Diseñador de Formularios y Controles de Formularios


Los controles de Visual FoxPro son flexibles y versátiles. Si bien hay múltiples controles que pueden emplearse para llevar a cabo una determinada tarea, necesitará emplear una estrategia coherente en relación con los controles que utiliza de modo que los usuarios sepan lo que pueden esperar cuando vean la interfaz que ha creado.

Por ejemplo, una etiqueta tiene un evento Click del mismo modo que un botón de comando, pero los usuarios suelen hacer clic en los botones de comando para realizar acciones.


Controles de Formularios

mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngclick_event.htm

La mayor parte de la funcionalidad que querrá incorporar a sus formularios corresponderá a una de estas categorías:

1. Proporcionar a los usuarios una serie de opciones predeterminadas

2. Permitir a los usuarios realizar acciones específicas

3. Mostrar información



Proporcionar una serie de opciones predeterminadas

Uno de los modos más sencillos de asegurar la validez de los datos de una base de datos consiste en proporcionar a los usuarios una serie de opciones predeterminadas.

Si controla las opciones del usuario puede asegurarse de que en la base de datos no se almacenan datos no válidos. Los controles siguientes permiten proporcionar a los usuarios una serie de opciones predeterminadas:

Grupos de botones de opción (radio)

Cuadros de lista y listas desplegables

Casillas de verificación (check)



Vamos a ver los controles mas utilizados, sus usos, propiedades y eventos asociados.

Es importante recalcar que hay propiedades y eventos comunes a varios controles, por lo que la primera vez que se vean, se explicarán en detalle.



Label (Control)

Crea un control Label que muestra texto. Observaciones

Un control Label es un control gráfico que muestra texto que no

puede cambiarse directamente. Sin embargo, puesto que un control Label tiene un amplio conjunto de propiedades, eventos y métodos en común con otros controles, puede responder a eventos y cambiarse dinámicamente en tiempo de ejecución.

Utilice la propiedad TabIndex para asignar un orden de tabulación a una etiqueta.

Los títulos se muestran de distinta forma según el objeto de que se trate.

256 es el número máximo de carácteres para la propiedad Caption de un control Label.



Propiedades

BackColor, ForeColor (Propiedades)

◦ Especifica el color de fondo o el color de primer plano usado para mostrar texto y gráficos en un objeto. Propiedad de lectura/escritura en tiempo de diseño y en tiempo de ejecución.

Object.BackColor[ = nColor] Object.ForeColor[ = nColor]

◦ Valores de la propiedad nColor

Especifica un valor de color simple. Si nColor es un valor negativo, Visual FoxPro utiliza el entero y pasa por alto los problemas de desbordamiento. Por ejemplo, -1 es el equivalente de 0xFFFFFFFF. La siguiente tabla muestra los valores típicos de colores.



Color Configuración RGB nColor

Blanco 255, 255, 255 16777215

Negro 0, 0, 0 0

Gris 192, 192, 192 12632256

Gris oscuro 128, 128, 128 8421504

Rojo 255, 0, 0 255

Rojo oscuro 128, 0, 0 128

Amarillo 255, 255, 0 65535

Amarillo oscuro 128, 128, 0 32896

Verde 0, 255, 0 65280

Verde oscuro 0, 128, 0 32768

Aguamarina 0, 255, 255 16776960

Verde azulado 0, 128, 128 8421376

Azul 0, 0, 255 16711680

Azul marino 0, 0, 128 8388608

Fucsia 255, 0 ,255 16711935

Fucsia oscuro 128, 0, 128 8388736


◦ Observaciones

Visual FoxPro utiliza un esquema de color rojo-verde-azul (RGB) para los colores. Los componentes rojo, verde y azul estan representados por un número entre 0 y 255. Utilice la función RGB( ) para convertir los tres colores componentes en un valor nColor compuesto.

Nota La propiedad ForeColor no se aplica a los controles CommandGroup, OptionGroup o Shape.



◦ Caption (Propiedad)

Especifica el texto que se muestra en el título de un

objeto. Disponible en tiempo de diseño y tiempo de ejecución.

Object.Caption[ = cTexto]

Valores de la propiedad

cTexto

Especifica el texto que se muestra en un objeto.



Observaciones ◦ Cuando se crea un nuevo formulario o control, el valor

predeterminado de la propiedad Name configura el valor determinado para la propiedad Caption. Este título predeterminado incluye el nombre de la clase del objeto y un número entero, por ejemplo, Command1, Combo1, o Form1.

◦ Utilice la propiedad Name para referirse a un objeto en código. La propiedad Caption describe solo el texto que aparece en la pantalla para identificar el control. Estas dos propiedades tienen el mismo valor, pero luego se configuran de forma diferente.

◦ Si no se especifica la configuración de la propiedad Width para un control, el control automáticamente ajusta el tamaño de forma que contenga el título.

◦ Para ajustar automáticamente un control Label para que se ajuste al título, configure la propiedad AutoSize como Verdadera (.T.). El número máximo de caracteres para la propiedad Caption de un control Label es de 256.



AutoSize (Propiedad) Especifica si se cambia automáticamente el tamaño de un

control para que quepan sus contenidos. Está disponible en tiempo de diseño y en tiempo de ejecución.

Control.AutoSize[ = lExpr]


lExpr Especifica si se cambia automáticamente el tamaño de un

control para que quepan sus contenidos. Los valores posibles de la propiedad AutoSize son:

◦ Verdadero (.T.) El control cambia automáticamente de tamaño para que quepan sus contenidos.

◦ Falso (.F.) (Valor predeterminado) Los contenidos se recortan cuando superan el área del control.



Enabled (Propiedad) ◦ Especifica si un objeto puede responder a eventos generados por el

usuario. Está disponible en tiempo de diseño y en tiempo de ejecución.

Object.Enabled[ = lExpr] Valores de la propiedad lExpr Los valores para la propiedad Enabled son: Verdadero (.T.) (Predeterminado) Un objeto responde a eventos. Falso (.F.) Un objeto no responde a eventos. Observaciones La propiedad Enabled permite que los objetos sean habilitados o

deshabilitados en tiempo de ejecución. Por ejemplo, puede habilitar objetos que no correspondan al estado actual de la aplicación. También puede deshabilitar un control para restringir su uso. Por ejemplo, un cuadro de edición puede deshabilitarse de forma que muestre información de sólo lectura. Si un control está deshabilitado, no se puede seleccionar.

Cuando un objeto contenedor tiene establecida su propiedad Enabled a falso (.F.), todos los controles que contiene están deshabilitados también. Por ejemplo, si el usuario hace clic en cualquiera de los controles contenidos en un formulario deshabilitado, no se desencadena ningún evento.


Name (Propiedad) Especifica el nombre del objeto al que se hace

referencia en el código.

Object.Name[ = cName] Valores de la propiedad cName ◦ Especifica el nombre empleado para hacer referencia al

objeto en el código.

Observaciones El nombre predeterminado de objetos nuevos es el

tipo del objeto más un entero único. Por ejemplo, el primer objeto Form nuevo será Form1, y el tercer cuadro de texto que cree en un Form será Text3.



Visible (Propiedad)

Especifica si un objeto está visible u oculto. Está disponible en tiempo de diseño y en tiempo de ejecución.

Object.Visible[ = lExpr] Valores de la propiedad lExpr

Los valores para la propiedad Visible son: Verdadero (.T.) El valor predeterminado en el Diseñador de

formularios. El objeto es visible. Falso (.F.) El objeto está oculto.



A continuación presentamos un resumen de las propiedades del control label mas utilizadas.

En la ayuda de Visual FoxPro encontrara (en caso lo requiera) una explicación de cada uno de las propiedades.



Resumen Alignment: (0Izqauierda, -1-Derecha 2-Centro) AutoSize: (False=Ajuste Manual True=Ajusta el

tamaño al ancho del Texto) BackColor: (Color de fondo para el texto) BackStyle: (0-Transparente, 1-Opaco(con fondo

gris) Caption: (Texto a Desplegar en el control) DisabledBackColor: (Color de fondo para el texto,

siempre que este el control deshabilitado (enabled=False) o en solo lectura (readonly=True) )

DisabledForeColor: (Color del Texto siempre que este el control deshabilitado (enabled=False) o en solo lectura(readonly=True) )

Enabled: (True=Habilitado, False=Deshabilitado o desactivado, no responde a eventos como clic)


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngalignment_property.htm

mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngautosize_property.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngdisabledbackcolor_disabledforecolor_properties.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngbackstyle_property.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngcaption_property.htm






mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngenabled_property.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngfontbold_fontitalic_fontstrikethru_fontunderline_properties.htm

FontBold:( True=Negrita Activada, False=Negrita desactivada-Letra normal)

FontItalic: ( True=Letra Cursiva Activada, False=cursiva desactivada-Letra normal)

FontSize: ( el numero digitado será el tamaño de la letra)

FontUnderline: ( True=Letra subrayada , False=Letra normal, sin subrayar)

ForeColor(Color del texto )

Name: (Nombre del Control, para sustituir el nombre default Labelxx, donde xx es el numero del control)

Visible: (True: Control visible, False: Control Invisible)

ToolTipText(texto de ayuda rápida que aparecerá encima del control al pasar el puntero del mouse)





mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngfontsize_property.htm




mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngbackcolor_forecolor_properties.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngname_property.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngvisible_property.htm


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngtooltiptext_property.htm


Existen varios eventos asociados a este control, pero no los veremos, ya que su uso lo limitaremos a presentar un texto en base a la propiedad caption, es decir que vamos a poder cambiar el valor de esta propiedad desde cualquier programa.

En caso necesite ver cuales son los eventos disponibles para este control, consulte la ayuda de Visual FoxPro



TextBox (Control)

Crea un cuadro de texto.

TextBox

Observaciones

Crea un cuadro de texto en el que puede modificar el contenido de una variable de memoria, un elemento de matriz o un campo.

Utilice las propiedades InputMask y Format para especificar cómo se escriben y muestran valores en el cuadro de texto.



Propiedades vistas: Alignment: (0Izqauierda, -1-Derecha 2-

Centro) BackStyle: (0-Transparente, 1-Opaco(con

fondo gris) DisabledBackColor: (Color de fondo para el

texto, siempre que este el control deshabilitado (enabled=False) o en solo lectura (readonly=True) )






































Otras propiedades:

InputMask (Propiedad)

Especifica cómo se introducen y muestran los datos en un control. Está disponible en tiempo de diseño y en tiempo de ejecución.

Control.InputMask[ = cMask]


cMask ◦ Los valores para la propiedad InputMask son:


Valor Descripción

! Convierte letras minúsculas a letras mayúsculas.

# Dígitos, espacios en blanco y signos.

$ El símbolo de moneda actual (especificado con SET CURRENCY) en

una posición fija.

$$ Muestra un símbolo de moneda flotante que siempre aparece junto a los

dígitos de los controles Spinner o TextBox.

, Valor actual del símbolo de agrupación de dígitos establecido en las

opciones de configuración regional del Panel de control de Windows.

. Carácter actual de SET POINT (valor predeterminado = punto (.)).

9 Pueden introducirse dígitos y signos, como el signo menos ( – ).

A Sólo caracteres alfabéticos.

L Sólo datos lógicos.

N Sólo letras y dígitos.

X Puede introducirse cualquier carácter.

Y Y, y, N y n para los valores lógicos verdadero (.T.) y falso (.F.),

respectivamente. miércoles, 05 de junio de 2013 Formularios con Visual Foxpro 27

Observaciones

Esta propiedad contrasta con la propiedad Format, en la que se especifica un comportamiento para todo el campo de entrada. Puede mezclar varios códigos de Format, pero siempre afectan a todo lo que hay en el campo de entrada.


Format (Propiedad) Especifica el formato de entrada y

resultados de la propiedad Value de un control. Está disponible en tiempo de diseño y en tiempo de ejecución.

Control.Format[ = cFunction] Valores de la propiedad cFunction ◦ Especifica las limitaciones de caracteres para la

introducción de datos y formato de la presentación. Los valores válidos de cFunction para un control EditBox son:


Valor Descripción

! Convierte los caracteres alfabéticos en mayúsculas. Utilícelo sólo con datos del

tipo Carácter.

$ Muestra el símbolo de moneda.

^ Muestra datos numéricos utilizando notación científica.

A Sólo permite caracteres alfabéticos (sin espacios ni signos de puntuación).

D Utiliza el formato actual de SET DATE.

E Edita los datos tipo Date como fecha BRITISH.

K Selecciona todo el texto cuando el control obtiene el enfoque.

L Muestra ceros a la izquierda (en lugar de espacios) en el cuadro de texto.

R Muestra la máscara de formato para el cuadro de texto especificada en la

propiedad InputMask. Los datos de formatos de máscaras para una entrada más

fácil y una presentación más clara (por ejemplo, si la máscara es 99-999, el

número 12345 se mostrará como 12-345), pero no se almacena como parte de los

datos. Se usa sólo con datos de caracteres o numéricos.

T Elimina los espacios en blanco iniciales y finales del campo de entrada.


Text (Propiedad) Contiene el texto sin formato escrito en la parte de cuadro de texto

de un control.

Object.Text

Observaciones A diferencia de la propiedad Value, el valor que contiene la propiedad

Text no tiene formato y es idéntico al texto escrito en el control por el usuario.

El texto sin formato contenido en la propiedad Text de un control puede ser distinto de la propiedad Value del control por las siguientes razones: ◦ Es posible que la propiedad Value no sea del tipo Carácter; puede

contener un valor de tipo Date o Numérico. ◦ Si la propiedad Format para el control utiliza el valor R, los caracteres de la

máscara de entrada se eliminarán de la propiedad Value.

Value (Propiedad) Valor que almacena el control. Object.Value


MaxLength: Especifica la longitud máxima (en caracteres) que puede escribirse en un control EditBox o en un control TextBox. Está disponible en tiempo de diseño y en tiempo de ejecución. ◦ Pierde el foco cuando alcanza su longitud máxima.


Eventos

Entre los eventos mas comunes para este control tenemos: GotFocus (Evento) Se produce cuando un objeto recibe el enfoque, bien mediante

acciones del usuario o mediante código. LostFocus (Evento) Se produce cuando un objeto pierde el enfoque.

Metodos

SetFocus (Método) Asigna el enfoque a un control. Control.SetFocus

Observaciones No puede asignar el enfoque a un control si las propiedades

Enabled o Visible del control están establecidas como falso


Refresh (Método)

Vuelve a dibujar un formulario o un control y actualiza todos los valores.

[Form.]Object.Refresh


EditBox (Control) Similar a un Textbox

Propiedades Value: Valor que almacena el control. MaxLength

Metodos y eventos similares al Textbox

No pierde el foco si se alcanza la longitud máxima. No aplica las propiedades Inputmask Format: Los valores válidos de esta propiedad para un control EditBox

son: ◦ K - Selecciona todo el texto cuando el control obtiene el enfoque.


mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngvalue_property.htm

mk:@MSITStore:c:/archivos de programa/microsoft visual studio/msdn98/98vsa/3082/foxhelp.chm::/html/lngvalue_property.htm

CommandButton (Control) Crea un botón de comando sencillo. CommandButton Observaciones Los botones de comando suelen emplearse

para iniciar un evento que lleva a cabo una acción, como cerrar un formulario, moverse a otro registro, imprimir un informe, etc.

Utilice la propiedad Caption para especificar el texto que aparece en un botón de comando. Utilice la propiedad Picture para especificar una imagen para un botón de comando.


Otras propiedades

AutoSize: (False=Ajuste Manual True=Ajusta el tamaño al ancho del Texto)

BackColor: (Color de fondo para el texto)

Caption: (Texto a Desplegar en el control)

DisabledBackColor: (Color de fondo para el texto, siempre que este el control deshabilitado (enabled=False) o en solo lectura (readonly=True) )








































Eventos

Click (Evento) Tiene lugar cuando el usuario presiona y suelta el botón

izquierdo del ratón.

PROCEDURE Object.Click

Observaciones ◦ El evento Click se produce cuando el usuario: Hace clic con el

botón primario del ratón en una casilla de verificación, un botón de comando, un cuadro combinado, un cuadro de lista o un botón de opción.

◦ Presiona la BARRA ESPACIADORA cuando un botón de comando, un botón de opción o una casilla de verificación tiene el enfoque.

◦ Presiona la tecla ENTRAR cuando un formulario tiene un botón de comando con la propiedad Default establecida en el valor verdadero (.T.).


Otros eventos ya vistos

GotFocus (Evento)

LostFocus (Evento)

Metodos

SetFocus (Método)

Refresh (Método)


CheckBox (Control)

Crea una casilla de verificación.

CheckBox

Observaciones

Una casilla de verificación sirve para alternar entre dos estados, como Verdadero (.T.) y Falso (.F.) y Nulo (.NULL.).

Los tres posibles estados para una casilla de verificación son determinadas por la propiedad Value.

.


Otras propiedades

Alignment: (0Izqauierda, -1-Derecha 2-Centro)


BackStyle: (0-Transparente, 1-Opaco(con fondo gris)









































Metodos SetFocus (Método) Refresh (Método)


GotFocus (Evento) LostFocus (Evento) Click (Evento)


OptionGroup (Control) Crea un grupo de botones de opción.

OptionGroup

Observaciones Los grupos de botones de opción son

contenedores que alojan botones de opción. Un grupo de botones de opción permite realizar una selección en un conjunto de botones. Al elegir un botón de opción, la selección se actualiza y se libera la opción anterior. Una viñeta al lado del botón de opción indica la opción actual.


Propiedades

ButtonCount (Propiedad) Especifica el número de botones de un

control OptionGroup.

Control.ButtonCount[ = nNumber] Valores de la propiedad nNumber ◦ Especifica el número de botones del control.


Para los controles ComboBox,ListBox, OptionGroup y Spinner, el valor de la propiedad Value es la cadena de caracteres o el valor numérico que esté seleccionado en ese momento.


Click (Evento)


Con este control tenemos el siguiente control:

OptionButton (Control)

Crea un botón de opción sencillo.

OptionButton

Observaciones

Un botón de opción sencillo sólo puede agregarse a un grupo de botones de opción.


Propiedades

Value: Determina o permite establecer si el control esta o no seleccionado.

Para un control OptionButton, los valores de la propiedad Value son: ◦ 0 (Predeterminado) Indica que el botón no está

seleccionado. ◦ 1 Indica que el botón está seleccionado.

Hay que tener cuidado con esta propiedad

si se establece vía código, ya que no desactiva el botón de opción que este seleccionado.


Otras propiedades

AutoSize: (False=Ajuste Manual True=Ajusta el tamaño al ancho del Texto)











































Metodos SetFocus (Método) Refresh (Método)


GotFocus (Evento) LostFocus (Evento) Click (Evento)


En las próximas clases veremos algunos ejemplos de su uso, así como el resto de controles y sus respectivas propiedades y eventos mas comunes.


Documents

Unidad v - 1 - Formularios en VFP (2013)