MODIFY FORM (Comando)

  • Artículo

Abre el Diseñador de formularios para que pueda modificar o crear uno.

MODIFY FORM [FormName | ?][NOWAIT][METHOD MethodName]
   [NOENVIRONMENT][SAVE] 
   [[WINDOW WindowName1] [IN [WINDOW] WindowName2 | IN SCREEN]]

Parámetros

  • FormName
    Especifica el nombre de archivo del Form. Si no especifica una extensión para el nombre de archivo, Visual FoxPro le asigna automáticamente la extensión .scx.

  • ?
    Muestra el cuadro de diálogo Abrir, en el que puede elegir un Form existente o introducir el nombre del Form nuevo que desea crear.

  • NOWAIT
    Continúa la ejecución del programa después de abrir el Diseñador de formularios. El programa no espera a que se cierre el Diseñador de formularios, sino que continúa la ejecución en la línea del programa que sigue inmediatamente a la línea que contiene MODIFY FORM NOWAIT. Si omite NOWAIT, cuando se ejecuta MODIFY FORM en un programa, se abrirá el Diseñador de formularios y la ejecución del programa se detendrá hasta que se cierre el Diseñador de formularios.

    NOWAIT sólo es efectivo desde dentro de un programa. No surte ningún efecto sobre MODIFY FORM cuando se ejecuta desde la ventana Comandos. Si se incluye NOWAIT con la cláusula METHOD, asegúrese de colocar NOWAIT antes de la cláusula METHOD o se ignorará.

  • METHOD MethodName
    Especifica un evento o un método para el que se abrirá la ventana Código en el Diseñador de formularios. La cláusula METHOD le permite iniciar inmediatamente la edición de código de evento o de método en el Diseñador de formularios.

    MethodName acepta la sintaxis de objetos de Visual FoxPro. Por ejemplo, para modificar inmediatamente el código de evento Click para un cuadro de texto llamado txtFirstName en un formulario llamado frmAddress, use el siguiente comando:

    MODIFY FORM frmAddress METHOD txtFirstName.Click

    Si sólo incluye un nombre de evento o de método en la cláusula METHOD, se abrirá la ventana Código para el evento o el método del formulario. Por ejemplo, para modificar inmediatamente el código de evento Click para un formulario llamado frmAddress, use el siguiente comando:

    MODIFY FORM frmAddress METHOD Click

  • NOENVIRONMENT
    Incluido por compatibilidad con las versiones anteriores de pantallas 2.x, que impide la restauración del entorno guardado con la pantalla.

    En Visual FoxPro, el entorno de datos asociado con un formulario de Visual FoxPro se restaura estableciendo la propiedad AutoOpenTables del entorno de datos en el valor verdadero (.T.), que es su valor predeterminado. Para asegurarse de que se ha cerrado el entorno del formulario al liberar el formulario, establezca la propiedad AutoOpenTables de entorno de datos en el valor verdadero (.T.), que además es su valor predeterminado.

    Cuando cree o modifique formularios, puede guardar el entorno de datos de Visual FoxPro actual con el archivo de definición del formulario. El hecho de guardar el entorno de datos de Visual FoxPro coloca registros adicionales en la tabla de definición de formularios para todas las tablas abiertas y archivos de índice, el orden del índice, y todas las relaciones entre tablas.

  • SAVE
    Cuando se ejecuta en un programa, deja el Diseñador de formularios abierto después de activar otra ventana. La inclusión de la opción SAVE no tiene ningún efecto cuando se ejecuta desde la ventana Comandos.

  • WINDOW WindowName1
    Especifica una ventana cuyas características adopta el Diseñador de formularios. Por ejemplo, si se crea la ventana con la opción FLOAT de DEFINE WINDOW, puede moverse el Diseñador de formularios. No es necesario que la ventana esté activa o sea visible, pero debe estar definida.

    El Diseñador de formularios tiene un tamaño predeterminado que puede ser mayor que la ventana de la que toma sus características. En este caso, el Diseñador de formularios sigue adoptando las características de la ventana en la que está situado. El ángulo superior izquierdo del Diseñador de formularios se sitúa en las mismas coordenadas que el ángulo superior izquierdo de la ventana y va más allá de los bordes de la ventana.

  • IN [WINDOW] WindowName2
    Especifica una ventana primaria en la que se abre el Diseñador de formularios. El Diseñador de formularios no toma las características de la ventana primaria y no puede moverse fuera de la ventana primaria. Si se mueve la ventana primaria, el Diseñador de formularios se mueve con ella.

    La ventana primaria debe definirse en primer lugar con DEFINE WINDOW y debe ser visible, para poder tener acceso al Diseñador de formularios.

  • IN SCREEN
    Especifica que el Diseñador de formularios se abre explícitamente en la ventana principal de Visual FoxPro, una vez que el Diseñador de formularios se ha situado en una ventana primaria. El Diseñador de formularios se sitúa en una ventana primaria al incluir la cláusula IN WINDOW.

Observaciones

Si ejecuta MODIFY FORM sin argumentos, aparecerá el cuadro de diálogo Abrir. Puede guardar el formulario con otro nombre cuando cierre el Diseñador de formularios.

Ejemplo

El ejemplo siguiente abre el control de muestra cronómetro (SWATCH.SCX) en el Diseñador de formularios.

MODIFY FORM (HOME(2) + 'solution\controls\timer\swatch.scx')

Vea también

COMPILE FORM | CREATE FORM | DO FORM