Команда MODIFY QUERY

Открывает конструктор форм, в котором можно модифицировать или создать запрос.

Синтаксис

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

Параметры

FileName

Задает имя файла запроса. Если имя файла указано без расширения, Visual FoxPro автоматически назначает ему расширение .QPR.

?

Отображает диалоговое окно Open, в котором можно выбрать существующий запрос и и ввести имя создаваемого запроса.

IN SCREEN

Явно открывает конструктор запросов в основном окне Visual FoxPro, после того как он помещен в родительское окно. Конструктор запросов помещается в родите ьское окно в результате включения предложения IN WINDOW.

IN MACDESKTOP

Допустимо только в FoxPro для Macintosh.

Помещает конструктор запросов в основное окно Macintosh. Конструктор запросов аходится на одном уровне с основным окном FoxPro; его можно сдвинуть за предел основного окна FoxPro и скрыть за ним.

При использовании предложения IN MACDESKTOP отменяется текущая установка SET MACDESKTOP. Эта установка определяет, где размещается конструктор запросов в с учае отсутствия предложений SCREEN и MACDESKTOP в основном окне FoxPro или в основном окне Macintosh. Подробнее о размещении конструктора запросов в основном окне FoxPro и в основном окне Macintosh см. тему SET MACDESKTOP.

NOWAIT

Продолжает выполнение программы сразу после открытия конструктора запросов. П ограмма не ждет закрытия конструктора запросов, а продолжает выполняться со ст оки, непосредственно следующей за строкой с командой MODIFY QUERY NOWAIT. Если предложение NOWAIT опущено, то когда команда MODIFY QUERY выдается в программе, конструктор запросов открывается и выполнение программы приостанавливается до тех пор, пока конструктор запросов не закроется.

Опция NOWAIT действует только в рамках программы. Если задать NOWAIT при вы аче команды MODIFY QUERY из окна команд, это никак не повлияет на ход работы.

SAVE

Оставляет конструктор запросов открытым после активизации другого окна. Если опустить предложение SAVE, конструктор запросов закрывается при активизации д угого окна. Включение опции SAVE не имеет никаких последствий, если команда вы ается из окна команд.

AS nCodePage

Задает кодовую страницу запроса. Используйте предложение AS nCodePage, если запрос был создан в кодовой странице, отличной от текущей кодовой стра ицы Visual FoxPro. При открытии запроса Visual FoxPro автоматически преобразует его в текущую кодовую страницу Visual FoxPro. Выдав функцию GETCP( ) для ко овой страницы nCodePage, вы можете отобразить диалоговое окно Code Page и задать в нем кодовую стра ицу для запроса.

Когда запрос закрывается, он сохраняется в своей исходной кодовой странице.

Если предложение AS nCodePage опущено или значение nCodePage равно 0, запрос не преобразуется в текущую кодовую страницу Visual FoxPro. Ес и заданная кодовая страница nCodePage не поддерживается, Visual FoxPro генерирует сообщение об ошибке.

В Visual FoxPro запросы можно включать в проект, задавать кодовую страницу зап оса в контейнере проекта. Контейнер проекта отслеживает информацию о кодовой странице запроса. Однако если вы открываете запрос вне контейнера проекта с помощью команды MODIFY QUERY, вам следует задать кодовую страницу запроса в пред ожении AS nCodePage.

Комментарии

Подробнее о создании запросов см. Создание запросов и главу 6 "Запрашивание данных" Руководства пользователя.

Если выдать команду MODIFY QUERY без аргументов, откроется диалоговое окно Open. Если в нем нажать кнопку New, запросу будет назначено имя QUERY1. При выходе из конструктора запросов вы можете сохранить этот запрос под другим именем.

После того как запрос создан, он сохраняется в виде файла программы Visual FoxPro с расширением имени .QPR. Вы можете выполнить программу запроса с помощью команды DO, но при этом необходимо вместе с именем файла запроса задать расшире ие .QPR.