MODIFY QUERY (Comando)

  • Artículo

Abre el Diseñador de consultas para que pueda modificar o crear una consulta.

MODIFY QUERY [FileName | ?] [[WINDOW WindowName1] [IN SCREEN]
   [NOWAIT] [SAVE] [AS nCodePage]

Parámetros

  • FileName
    Especifica el nombre de archivo para la consulta. Si no se incluye ninguna extensión con el nombre del archivo, Visual FoxPro le asignará automáticamente la extensión .qpr.

  • ?
    Muestra el cuadro de diálogo Abrir, en el que puede elegir una consulta existente o introducir el nombre de una nueva consulta que desee crear.

  • WINDOW WindowName1
    Especifica la ventana de la que el Diseñador de consultas va a tomar las características. Por ejemplo, si se ha creado la ventana con la opción FLOAT de DEFINE WINDOW, se podrá desplazar el Diseñador de consultas. No es necesario que la ventana esté activa o sea visible, pero debe estar definida.

  • IN SCREEN
    Abre explícitamente el Diseñador de consultas en la ventana principal de Visual FoxPro, después de situarlo en una ventana primaria. El Diseñador de consultas se sitúa en una ventana primaria incluyendo la cláusula IN WINDOW.

  • NOWAIT
    Continúa la ejecución del programa después de que se haya abierto el Diseñador de consultas. El programa no espera a que se cierre el Diseñador de consultas, sino que continúa la ejecución en la línea de programa siguiente a la que contiene MODIFY QUERY NOWAIT. Si omite NOWAIT al ejecutar MODIFY QUERY en un programa, el Diseñador de consultas se abre y la ejecución del programa se interrumpe hasta que se cierre el Diseñador de consultas.

    NOWAIT sólo es efectivo desde dentro de un programa. No tiene ningún efecto sobre el comando MODIFY QUERY cuando se ejecuta desde la ventana Comandos.

  • SAVE
    Deja abierto el Diseñador de consultas después de activar otra ventana. Si omite SAVE, el Diseñador de consultas se cerrará cuando se active otra ventana. El hecho de incluir SAVE no tiene ningún efecto cuando se ejecuta desde la ventana Comandos.

  • AS nCodePage
    Especifica la página de códigos de la consulta. Incluya AS nCodePage si la consulta se creó con una página de códigos distinta de la activa en Visual FoxPro. Cuando se abre la consulta, Visual FoxPro convierte automáticamente la consulta a la página de códigos actual de Visual FoxPro. Puede utilizar GETCP( ) para que nCodePage muestre el cuadro de diálogo Página de códigos, que permite especificar una página de códigos para la consulta.

    La consulta se guarda en su página de códigos original cuando se cierra.

    Si omite la cláusula AS nCodePage o nCodePage es 0, la consulta no se convierte a la página de códigos actual de Visual FoxPro. Si especifica un valor no admitido para nCodePage, Visual FoxPro generará un mensaje de error.

    En Visual FoxPro, las consultas se pueden agregar a un proyecto, y el usuario puede especificar la página de códigos de la consulta desde el Contenedor de proyectos. El Contenedor de proyectos conserva un registro de la página de códigos de la consulta. No obstante, si utiliza MODIFY QUERY para abrir una consulta fuera del Contenedor de proyectos, debe incluir AS nCodePage para especificar la página de códigos de la consulta.

Observaciones

Para obtener más información acerca de cómo crear consultas, vea Crear una consulta.

Al ejecutar MODIFY QUERY sin ningún argumento se muestra el cuadro de diálogo Abrir. Si elige Nuevo en este cuadro de diálogo, se asigna el nombre CONSULTA1 a la consulta. Puede guardar la consulta con otro nombre distinto al salir del Diseñador de consultas.

Después de crear una consulta, ésta se almacena como un archivo de programa de Visual FoxPro con la extensión .qpr. Puede ejecutar un programa de consulta con DO, pero es necesario incluir la extensión .qpr con el nombre del archivo de consulta.

Vea también

CREATE QUERY | DO | GETCP( )