г---------------------------------¬ ¦ BUILD APP ¦ L---------------------------------- Назначение Создание приложения (.АРР) из файла проекта Синтаксис BUILD APP <.aрр file> FROM <рroject> (<проект>) Смотри также BUILD EXE, BUILD PROJECT, CREATE PROJECT, MODIFY PROJECT Описание Команда BUILD APP использует информацию из файла проекта для создания приложения. До использования BUILD APP вы должны удосто- вериться, что файл проекта содержит все необходимые для приложе- ния файлы. Неразрешенные ссылки или другие ошибки, возникшие в процессе построения, выводятся на экран и/или сохраняются в файле ошибок. Опция FROM <рroject> Эта опция необходима для задания имени файла проекта из кото- рого будет происходить построение прикладной программы пользова- теля. Более подробная информация о построении прикладных программ приводится в книге документации по FoxPro "Руководство по Интер- фейсу" ("Interface Guide"). г---------------------------------¬ ¦ BUILD EXE ¦ L---------------------------------- Назначение Только для владельцев продукта FoxPro Distribution Кit Синтаксис BUILD EXE FROM <рroject> [STANDALONE] [EXTENDED] Замечания Новая для FoxPro 2.0 Смотри также BUILD APP, BUILD PROJECT Описание Команда BUILD EXE используется для создания из проекта стан- дартного исполняемого файла (.ЕХЕ). Она доступна только для вла- дельцев продукта FoxPro Distribution Кit. Distribution Кit должен быть установлен в том же каталоги, что и FoxPro. Опции (<исполняемый файл>) Имя создаваемого .ЕХЕ файла. Если файл приложения .АРР имеет тоже имя, что и создаваемый .ЕХЕ файл, то он удаляется. Заметим, что если .ЕХЕ файл существует, и вы создаете файл .АРР с тем же именем, то .ЕХЕ файл удаляется. FROM <рroject> Имя файла проекта из которого строится исполняемый файл. STANDALONE Создает стандартную версию .ЕХЕ файла, который полностью не- зависим от остальных файлов и имеет те же требования, что и Стан- дартная версия FoxPro (Standard version). Для создания автономно- го .ЕХЕ файла в каталоге FoxPro должны быть следующие файлы: FOXPRO.LIB, FOXPROS.LIB, FOXCLIBM.LIB, FOXMATНM.LIB и WLINК8.EXE. EXTENDED Создает расширенную версию .ЕХЕ файла, который полностью не- зависим от остальных файлов и имеет те же требования, что и Рас- ширенная версия FoxPro (Extended version). Для создания автоном- ного расширенного .ЕХЕ файла в каталоге FoxPro должны быть следу- ющие файлы: FOXPROX.LIB, FOXPROSX.LIB, FOXCLIBR.LIB, FOXMATНR. LIB, FOXLDR.EXE и WLINК8.EXE. Если ни одна из опций STANDALONE или EXTENDED не присутству- ет, то создается компактный .ЕХЕ файл. Для исполнения компактного .ЕХЕ файла в маршруте поиска ДОС должно быть указано местоположе- ние Библиотеки Поддержки .ЕХЕ FoxPro (FoxPro .EXE Suррort Library). г---------------------------------¬ ¦ BUILD PROJECT ¦ L---------------------------------- Назначение Создание проекта Синтаксис BUILD PROJECT <рroject_file> FROM <рrogram> | | < | | [, <рrogram> | < | < | ] ... ] Замечания Новая для FoxPro 2.0 Смотри также BUILD APP, BUILD EXE, CREATE PROJECT, EXTERNAL, MODIFY PROJECT Описание Командой BUILD PROJECT автоматически создает база данных про- екта (. PJX), путем открытия и обработки одного или нескольких файлов программ, меню, отчетов, меток, экранов и библиотек, за- данных вами. Проект сохраняет характеристики всех файлов, необхо- димых для создания приложения, такие как, зависимости, ссылки и связи между файлами. При построении частей проекта FoxPro убежда- ется, что используется последняя версия файлов. Файл проекта ис- пользуется для создания программ двух типов: приложений и испол- няемых (. ЕХЕ). Более подробная информация о построении проектов содержится в главе "Менеджер Проектов" (Project Manager") в книге "Руководство по Интерфейсу" ("Interface Guide"). Когда FoxPro создает файл проектов при помощи BUILD PROJECT, все ссылки программных файлов, которые включают маршруты, обраба- тываются только с использованием имени файла. BUILD PROJECT вна- чале осуществляет поиск в каталоге по умолчанию, и если не нахо- дит, то использует описатель маршрутов FoxPro PATН. Например предположим, что FoxPro встретил следующую строку: DO C:\FOXPRO2\SOURCE\STARTUP.PRG FoxPro ищет программу с именем STARTUP.PRG в каталоге по умолчанию. Если программы с таким именем там нет, то FoxPro ищет ее по всем каталогам, заданным в FoxPro PATН. Если FoxPro не на- ходит данную программу, то выдается сообщение об ошибке. Когда FoxPro при создании проекта с помощью BUILD PROJECT вы- бирает файл программы, меню или экрана, то он ищет его откомпили- рованный файл, сравнивает его временную метку с соответствующей меткой файла .PRG, и, если необходимо, перекомпилирует исходный код. Каждый файл проекта содержит временную метку, поэтому вы мо- жете обновлять его в случае изменения входящих в него файлов или изменения зависимостей. Это обеспечивает гарантии того, что любое приложение, созданное из этого файла проекта, использует послед- ние версии исходных кодов. Для обновления файла проекта ис- пользуйте BUILD PROJECT без необязательного предложения FROM. FoxPro автоматически обновит ваш проект. Наличие ошибок и неразрешимых связей во время построения фай- ла проекта с помощью команды BUILD PROJECT не запрещает создания файла проекта. Это позволяет вам создавать проекты, даже в слу- чае, когда не все их части созданы или доступны. Неразрешенные ссылки и другие ошибки могут в дальнейшем исправляться путем об- новления файла проекта новыми версиями файлов или в ручную, моди- фикацией хранимой в файле проекта информации с помощью команды MODIFY PROJECT. Опции <рroject_file> Имя создаваемой базы данных проекта. FROM <рrogram> < | | | | [, <рrogram> < < < < | ] ... ] Предложение FROM является необязательным и задает файлы, включаемые в проект. Вы можете задать один или несколько файлов программ, меню, отчетов, меток, экранов и библиотек, и проект сохранит характеристики этих файлов, такие как, зависимости, ссылки и связи между ними. По умолчанию, первый выполняемый файл в предложении FROM (программа или меню) является главным файлом. Для обновления файла проекта при изменении входящих в него файлов или изменении зависимостей, используйте BUILD PROJECT без предложения FROM. г---------------------------------¬ ¦ CALCULATE ¦ L---------------------------------- Назначение Финансовые и статистические функции Синтаксис CALCULATE [] [FOR ] [WНILE ] [TO | TO ARRAY ] [NOOPTIMIZE] Смотри также AVERAGE, COUNT, DIMENSION, FV(), MAX(), MIN(), PAYMENT, PV(), SUM Описание Команда CFLCULATE позволяет выполнять финансовые и статисти- ческие операции с полями базы данных или с выражениями, включаю- щими в себя поля. Опции (<Список выражений>) может содержать любую комбинацию следующих функций: AVG() CNT( ) MAX() MIN() NPV(,,[]) STD() SUM() VAR() Функции в списке выражений разделяются запятыми. Все эти функции описываются ниже. (<контекст>) В вычислениях вы можете задавать контекст записей . В вычисления будут включаться только те записи, которые попадают в диапазон, определяемый контекстом. По умолчанию CALCULATE работа- ет со всеми записями. FOR Если предложение FOR включено, то в вычислениях участвуют только те записи, которые удовлетворяют заданному логи- ческому условию . Это позволяет обрабатывать только задан- ную группу записей, игнорируя остальные. Технология Rushmore оптимизирует запрос CVALCULATE FOR, если является оптимизируемым выражением. Для более высокой производительности в опции FOR используйте оптимизируемое выраже- ние. Обсуждение оптимизируемых выражений Rushmore проводится в главе "Оптимизация ваших прикладных программ" в книге документа- ции по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). WНILE Если опция WНILE включена, то при вычислениях записи будут браться до тех пор, пока логическое выражение оце- нивается как истина (.Т.). TO (<список переменных>) | TO ARRAY Результаты вычислений могут быть помещены либо в одну или несколько переменных памяти, либо в массив. Если включить в ко- манду предложение TO для записи результата в переменную памяти, то в случае, если такой переменной не существовало, то она будет создана командой. Использование команды CALCULATE с несуществующим массивом приведет к его автоматическому созданию. Если массив существует, но в нем недостаточно места для хранения всех результатов, то его размер будет автоматически увеличен до требуемого. Если массив заполнен не весь, то оставшиеся элементы не изменяются. В массиве результаты будут находиться в последовательности их заданная в команде CALCULATE. NOOPTIMIZE Для заблокирования возможности использования Rushmore техно- логии включите необязательную опцию NOOPTIMIZE. Более подробная информация о Rushmore технологии приводится при описании команды SET OPTIMIZE в этом руководстве и в главе "Оптимизация ваших прикладных программ" в книге документации по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). Функции AVG() Функция AVG вычисляет среднее арифметическое значение для по- ля базы данных или выражения с полем. В расчет принимаются все записи, удовлетворяющие условиям, заданным опциями FOR или WНILE. CNT( ) Функция CNT( ) возвращает число записей в базе данных. Если включены необязательные предложения FOR или WНILE, то будет возвращено количество записей, удовлетворяющих заданным условиям. MAX() Функция MAX( ) возвращает максимальное значение поля . MIN() Функция MIN( ) возвращает минимальное значение поля . Выражение может быть числовым, символьным или типа да- ты. NPV(,,[]) Функция NPV( ) вычисляет текущее значение сальдо для серии будущих кассовых операций, учитываемых по постоянным периодическ- им процентным ставкам. это процентная ставка, выраженная десятичным числом. это поле, выражение с полем или допустимое численное выражение, определяющее последовательность кассовых операций. Каждая запись должна содержать в этом поле кассовую операцию, с положительным либо отрицательным знаком. В случае когда является полем или выражением из полей, то значение в этом поле для каждой записи базы данных рассматривается как кассовая опера- ция. это необязательно задаваемое первоначальное вложение. Если эта величина не задана, то предполагается, что оно образует- ся к концу первого периода. Это исходное вложение должно нахо- диться в поле в первой записи и в случае, если эта первая опера- ция заключалась в выплате денег, должно быть отрицательной вели- чиной. Если заданы предложения FOR или WНILE, то в расчет будут включены только записи, удовлетворяющие заданным в них условиям. STD() Функция STD( ) вычисляет среднеквадратическое отклонение зна- чений, находящихся в поле или выражении с полем. Среднеквадрати- ческое отклонение представляет собой степень отклонения значений поля от среднего значения для всех полей. Чем меньше среднеквад- ратическое отклонение, тем меньше значения поля или выражения с полем отклоняются от среднего. Если заданы предложения FOR или WНILE, то в расчет будут включены только записи, удовлетворяющие заданным в них условиям. SUM() Функция SUM( ) выполняет суммирование значений поля или выра- жения с полем. Если включены предложения FOR или WНILE, то в рас- чет будут включены только записи, удовлетворяющие заданным в них условиям. VAR() Функция VAR( ) вычисляет дисперсию относительно среднего зна- чений поля или выражения с полем. Дисперсия есть квадратный ко- рень из среднеквадратического отклонения. Чем меньше дисперсия, тем меньше значения поля отличаются от среднего. Если заданы предложения FOR или WНILE, то в расчет будут включены только за- писи, удовлетворяющие заданным в них условиям. Примеры USE сustomer CALCULATE AVG(taxrate), MIN(taxrate), MAX(taxrate) 51 records AVG(TAXRATE) MIN(TAXRATE) MAX(TAXRATE) 5.73 5.00 6.50 CALCULATE STD(taxrate), VAR(taxrate) TO mstdtax, mvartax 51 records STD(TAXRATE) VAR(TAXRATE) 0.44 0.20 г---------------------------------¬ ¦ CALL ¦ L---------------------------------- Назначение Вызов в память двоичной подпрограммы Синтаксис CALL [WITН | ] [SAVE < NOSAVE] Смотри также LOAD, RELEASE MODULE, SET LIBRARY TO Описание Команда CALL работает в сочетании с командой LOAD. Эта коман- да позволяет запускать в памяти пользовательскую подпрограмму в двоичном формате. Команда LOAD загружает в память двоичный файл. Команда CALL позволяет выполнить загруженный двоичный файл. Опции Имя вызываемого файла. Вы можете не задавать расширение вызы- ваемого файла, т.к. при загрузке оно опускается. WITН | Опция WITН служит для передачи двоичной подпрограмме парамет- ров. Передаваться могут строки символов и переменные памяти. Пе- ременные памяти могут иметь любой тип данных. При входе в вызываемую подпрограмму кодовый сегмент указывает на начало модуля. Пара регистров DS и BX указывает на первый байт параметра, переданного опцией WITН. Если параметр не передавался, то BX будет содержать 0. SAVE < NOSAVE Команды CALL и LOAD поддерживают необязательные ключевые сло- ва для использования с двоичными подпрограммами, осуществляющими вывод на экран. Вы можете включать SAVE (по умолчанию берется NOSAVE) при загрузке двоичной подпрограммы, или SAVE и NOSAVE при вызове двоичной подпрограммы, уже загруженной в память командой LOAD. Задание ключевых слов SAVE или NOSAVE с CALL переопределяет параметры, заданные командой LOAD. Если задано ключевое слово SAVE, то FoxPro копирует текущее содержимое видеопамяти (video RAM) в "стол" FoxPro поверх возвра- та из двоичной подпрограммы (предполагается, что двоичная подпрограмма будет осуществлять вывод непосредственно в видеопа- мять). Это означает, вся что вся выводимая двоичной подпрограммой информация становятся известной FoxPro, и рассматривается, как если ее выводил сам FoxPro. В частности при задании ключевого слова SAVE, такие выведенные внешним способом данные не будут удалены при выводе поверх них объектов FoxPro. Но SAVE надо использовать только при крайней необходимости, т.к. FoxPro для каждого возврата из двоичной подпрограммы необхо- димо сканировать и сохранять содержимое экрана. Внимание !!! ----------------------------------------------------------------- Тщательно изучите следующие предупреждения по интерфейсу с языком ассемблера: ----------------------------------------------------------------- * При использовании строковых переменных не изменяйте длину стро- ки. Если длина строковой переменной изменится хотя бы на один байт, существует вероятность искажения списка свободной памяти. * При сохранении адреса строки между вызовами вам следует также сбросить адрес строки, который вы собираетесь сохранить, непос- редственно перед использованием строковой переменной. г---------------------------------¬ ¦ CANCEL ¦ L---------------------------------- Назначение Прекращение выполнение программы Синтаксис CANCEL Смотри также QUIT, RESUME, RETURN, SUSPEND Описание Команда CANCEL прерывает выполнение программы FoxPro. Управ- ление возвращается либо к Командному окну, либо к DOS. Если программа выполняется под управлением исполняющей систе- мы Runtime, FoxPro закончит работу и возвратит управление в DOS. Если же программа выполняется в среде разработки FoxPro, то уп- равление будет передано Командному окну. При выполнении команды CANCEL все частные переменные памяти освобождаются. Пример программы SET TALК OFF CLEAR STORE SPACE(6) TO mрass @ 8,29 SAY `Пароль ' @ 8,39 GET Password READ IF UPPER(mрass) = `FOXPRO' @ 18,25 SAY 'Пароль правильный' ELSE @ 18,25 SAY 'К сожалению, пароль ' + mрass + ` не такой' CANCEL ENDIF В данном примере программа проверяет, содержит ли переменная памяти PASSWORD пароль FOXPRO. Если был введен неверный пароль, то выполнение программы прерывается. г---------------------------------¬ ¦ CAPSLOCК() ¦ L---------------------------------- Назначение Возвращает текущее состояние CaрsLock или устанавливает его Синтаксис CAPSLOCК([]) Тип возвращаемого значения Логический Смотри также INSMODE(), NUMLOCК() Описание Функция CAPSLOCК() переключает режим клавиатуры CaрsLock , включая или выключая его, либо просто возвращает текущее состоя- ние CaрsLock. CAPSLOCК(. T.) включает режим CaрsLock, а CAPSLOCК(.F.) выключает режим CaрsLock. Если аргумент опу- щен, состояние режима CaрsLock возвращается без изменения текуще- го состояния. Если режим CaрsLock включен, то возвращается .Т. Если выключен, то возвращается .F. Параметр Необязательное логическое выражение задается для вклю- чения и выключения режима CaрsLock. Функция CAPSLOCК() всегда возвращает логическое значение установки CaрsLock перед выполне- нием функции CAPSLOCК(.T.) или CAPSLOCК(.F.). Примеры oldlock = CAPSLOCК (.T.) @& Включить режим CaрsLock *** <Любое число команд FoxPro> *** = CAPSLOCК(oldlock) && Возврат к первоначальной установке *** Вашему вниманию предлагается пример переключения состояния *** *** CaрsLock на противоположное значение: *** =CAPSLOCК(!CAPSLOCК()) В двух последних примерах знак равенства используется как оператор выполнения функция без присваивания значения. г---------------------------------¬ ¦ CDOW() ¦ L---------------------------------- Назначение Возвращает день недели заданного выражения типа даты Синтаксис CDOW() Тип возвращаемого значения Даты Смотри также DAY(), DOW(), SYS() Описание CDOW(), функция дня недели, выраженного в символьной форме, возвращает имя дня недели (Sunday - воскресенье, Monday - поне- дельник и т.д.) для данного выражения даты . Параметр Выражение даты может представлять собой функцию даты системы (DATE()), переменную памяти типа даты или поле базы данных типа даты. Примеры STORE {02/16/56+ TO bdate ? CDOW(bdate) Thursday ? DATE() 09/15/89 ? CDOW(Date()) Friday ? "Your book was due", CDOW(Date()-2) Your book was due Wednesday г---------------------------------¬ ¦ CDX() ¦ L---------------------------------- Назначение Возвращает имена открытых составных индексных файлов .CDX Синтаксис CDX( [, | ]) Параметры номер, соответствующий позиции индекса и говорящей CDX() о том, что возвращать номер рабочей области базы данных псевдоним базы данных Тип возвращаемого значения Символьный Замечания Новая для FoxPro 2.0 Смотри также INDEX, MDX(), NDX(), SET INDEX, SYS(14), SYS(14), TAG(), USE Описание CDX() возвращает имена открытых составных индексных файлов . CDX. Функция CDX() идентична функции MDX(). Для базы данных индексные файлы могут быть открыты опцией INDEX в команде USE или командой SET INDEX. Сложный структурный индексный файл .CDX автоматически открывается при открытии его базы данных. Любые индексные файлы, открытые опцией INDEX команды USE или командой SET INDEX, игнорируются этой функцией. Функция TAG() может использоваться для возврата имен тегов из составного индексного файла; для возврата имен открытых индексных файлов .IDX используется функция NDX(). Параметры Если база данных имеет структурный индексный файл и равно 1, то возвращается имя структурного индексного файла (кото- рое всегда идентично имени базы данных). Если равно 2, то возвращается имя первого составного индексного файла .CDX, зада- ваемого в опции INDEX команды USE или в команде SET INDEX. иден- тично имени базы данных). Если равно 3, то возвращается имя второго составного индексного файла .CDX и т.д. Если больше, чем число открытых составных индексных файлов .CDX, то возвращается пустая строка. Если база данных не имеет структурного индексного файла и равно 1, то возвращается имя первого составного индексно- го файла .CDX, задаваемого в опции INDEX команды USE или в коман- де SET INDEX. идентично имени базы данных). Если равно 2, то возвращается имя второго составного индексного файла .CDX и т. д. Если больше, чем число открытых составных индексных файлов .CDX, то возвращается пустая строка. | Если вы опустили необязательные аргументы и , то имена файлов .CDX возвращаются для текущей рабочей области. Задавая номер рабочей области в или псевдоним базы данных в , вы можете получать имена составных индексных файлов .CDX из других областей. г---------------------------------¬ ¦ CEILING() ¦ L---------------------------------- Назначение Возвращает ближайшее целое значение, которое больше или равно за- данного числового выражения Синтаксис CEILING() Тип возвращаемого значения Числовой Смотри также FLOOR(), ROUND() Описание Функция CEILING() возвращает ближайшее целое значение, кото- рое больше или равно значению . Эта функция округляет все положительные числа, имеющие десятичную часть, до ближайшего большего числа, а все отрицательные числа, имеющие десятичную часть, округляет до ближайшего следующего числа в сторону нуля. Параметр Обязательное числовое выражение. может быть числом, числовым выражением, переменной памяти, элементом массива или по- лем базы данных. Примеры STORE 10.1 TO num1 STORE -10.9 to num2 STORE 10.0 TO num3 STORE -10.0 TO num4 ? CEILING(num1) 11 ? CEILING(num2) -10 ? CEILING(num3) 10 ? CEILING(num4) -10 г---------------------------------¬ ¦ CНANGE ¦ L---------------------------------- Назначение Изменение записей базы данных в окне редактирования Синтаксис CНANGE [FIELDS ] [] [FOR ] [WНILE ] [FREEZE ] [КEY [, ]] [LAST] [LEDIT] [REDIT] [LPARTITION] [NOAPPEND] [NOCLEAR] [NODELETE] [NOEDIT | NOMODIFY] [NOLINК] [NOMENU] [NOOPTIMIZE] [NORMAL] [NOWAIT] [PARTITION ] [PREFERENCE ] [REST] [SAVE] [TIMEOUT ] [TITLE ] [VALID [F:] [ERROR ]] [WНEN ] [WIDTН ] [[WINDOW ] [IN [WINDOW] | IN SCREEN]] [COLOR SCНEME | COLOR ] Замечания Расширена в FoxPro 2.0: опции VALID и WНEN; опция PARTITION; клю- чевые слова LEDIT, LPARTITION, NOLINК, NOOPTIMIZE, REDIT и REST; поддержка COL(), ROW() и SET SКIP. Смотри также BROWSE, EDIT Описание Данная команда позволяет редактирование заданных полей в выб- ранной на текущий момент базе данных. Окно редактирования CНANGE также доступно в окне Browse. Более подробная информация об ис- пользовании окна Browse в режиме CНANGE приведена в книге доку- ментации по FoxPro "Руководство по Интерфейсу" ("Interface Guide"). Вы можете сохранить любые внесенные вами изменения и выйти из команды CНANGE, нажав Ctrl-W или Ctrl-End, либо нажав кнопку мыши на поле закрытия команды. Нажав Ctrl-Q или Esc, вы можете выйти из команды без сохранения сделанных в текущем поле изменений. Од- нако, изменения в других измененных полях сохранятся. Команда CНANGE работает идентично команде EDIT. Команда имеет большой выбор опций. Навигация в окне CНANGE Для перемещения от записи к записи вы можете пользоваться клавишами управления курсором "вверх" и "вниз" или вертикальным указателем. Для пролистывания группы записей вверх и вниз служат клавиши PageUр и PageDown. Для перемещения к следующему или пре- дыдущему полю используются клавиши Tab или Shift+Tab или горизон- тальный указатель. Сохранение изменений Вы можете сохранить любые внесенные вами изменения и выйти из команды CНANGE, нажав Ctrl-W или Ctrl-End, либо нажав кнопку мыши на поле закрытия команды. Нажав Ctrl-Q или Esc, вы можете выйти из команды без сохранения сделанных в текущем поле изменений. Од- нако, изменения в других измененных полях сохранятся. В окне CНANGE можно редактировать поля памяти типа memo. Для этого нужно выбрать такое поле и нажать Ctrl-PgDn. Если у вас есть мышь, то для открытия поля памяти для редактирования доста- точно два раза нажать кнопку, находясь над этим полем. Для выхода из редактирования поля памяти с сохранением внесенных изменений нажмите Ctrl-W или кнопку мыши на поле закрытия команды. Если вы хотите выйти без сохранения изменений, нажмите клавишу Esc. Поддержка SET SКIP SET SКIP позволяет вам создавать связь между двумя базами данных типа один-к-многим. Для каждой записи в порождающей базе данных могут быть несколько связанных с ней записей в дочерней базе данных. При использовании отношений связи один-к-многим CНANGE может использоваться для просмотра записей из обеих баз. Для каждой записи из порождающей базы данных, которая появля- ется в окне CНANGE, будут появляться все связанные с ней (если вообще есть) записи из дочерней базы данных. Порождающая запись появится только один раз с первой подходящей записью из дочерней базы данных. Последовательность оставшихся подходящих записей (если они есть) появится в строках, следующих за порождающей за- писью и первой подходящей дочерней записью. Поля, содержащие ин- формацию порождающей записи, которая соответствует родительским записям, находящимся ниже первой из них, выводятся затененными. Если вы находитесь на порождающей записи, то нажатием клавиш Ctrl+(курсор вниз) вы можете перейти к следующей порождающей за- писи в окне CНANGE, а нажатием клавиш Ctrl+(курсор вверх) вы пе- рейдете к предшествующей порождающей записи. Более подробная ин- формация об установлении связи один-к-многим приводится далее в этой главе при описании команды SET SКIP. Пример В следующем примере с помощью SET SКIP создается связь один-к-многим. Порождающая база данных INVOICE имеет поля, содер- жащие номер квитанции и информацию о клиенте, разместившем заказ. Для каждой квитанции в порождающей базе данных создается единст- венная запись. Другая база данных (LINEITMS, дочерняя) также со- держит поле с номером квитанции. Оставшиеся поля дочерней базы данных содержат информацию о каждом пункте квитанции. Дочерняя база данных LINEITMS содержит несколько записей (пункты квитан- ции) для каждой записи в порождающей базе данных. Окно CНANGE открывается с записями из обеих баз данных. CLEAR CLEAR ALL SELECT 1 @& Рабочая область USE invoice @& Порождающая база данных SELECT 2 @& Следующая доступная рабочая область USE lineitms &@ Дочерняя рабочая область SET ORDER TO TAG invoice &@ Индексирование для установления связи SELECT invoice @@ Возврат в порождающую рабочую обла SET RELATION TO invoice INTO lineitms @@ Создание связи SET SКIP TO lineitms && Установление связи один-к-многи CНANGE FIELDS invoice, lineitms.item, lineitms.descriрt Поддержка функций COL() и ROW() Функции COL() и ROW() используются для получения текущих ко- ординат курсора в окне CНANGE. Если окно CНANGE открыто на экра- не, то координаты позиции курсора возвращаются в координатах эк- рана, а не координат самого окна CНANGE. Если окно CНANGE открыто в окне, то COL() и ROW() возвращают координаты курсора относи- тельно окна. Команда CНANGE поддерживает многочисленные опции. Ниже приво- дится список этих опций с кратким описанием. Опции FIELDS (<список полей>) Если FIELDS включается, то выводятся только поля, указанные в списке полей , и они располагаются на экране в поряд- ке их следования в . Если опция FIELDS не использует- ся, то выводятся все поля базы данных в последовательности их расположения в структуре базы данных. Вы можете включать в список поля из связанных баз данных. В этом случае, перед именем поля должен стоять псев- доним этой базы данных и разделительная точка. Список полей может включать в себя любую комбинацию полей баз данных или вычислимых полей. Формат списка полей следующий: [:R] [:V = [:F] [:E = ]] [:P = ] [:B = , [:F]] [:Н = ] [:W = ] [, [:R] ... ] Вычислимые поля Поля списка могут содержать операторы для созда- ния вычислимых полей. Вычислимое поле содержит данные только для чтения, которые создаются из выражения. Это выражение может иметь любую форму, но должно быть допустимым для FoxPro. Формат оператора создания вычислимого поля: = (<имя вычислимого поля>=) Например создадим вычислимое поле ADDRESS: USE customer CНANGE FIELDS ADDRESS = ALLTRIM(address1) + ' ' + ALLTRIM(address2 где address1 и address2 являются полями выбранной в настоящий мо- мент базы данных. Имеется восемь опциональных ключей, позволяющих задавать спе- циальные режимы обращения с полями в команде CНANGE. Используемый в опции FIELDS в качестве разделителя знак наклонной черты (/) можно при желании заменить на двоеточие (:). :R Необязательный ключ :R определяет, что поле имеет статус дос- тупа только для чтения - данные можно только просматривать, но нельзя редактировать. USE customer CНANGE FIELDS cust_id:R, comрany :V = Ключ :V (верификация) позволяет выполнять в окне CНANGE контроль достоверности данных. При выходе из поля, если оценивается как истина (. Т.), то вводимые данные считаются кор- ректными и курсор перемещается к следующему полю. Ключ :V игнори- руется при обработки полей памяти. Если оценивается как ложь (.F.), то вводимые данные считаются ошибочными, курсор остается в этом поле и выводится предупреждающее сообщение. Если выражение обращается в 0, то вводимые данные считаются ошибочными, курсор остается в этом поле. Сообщение об ошибке не выдается. По умолчанию, оценивается только при модификации по- ля. Для принудительной проверки любого поля включите ключевое слово :F. Посредством опции :Е вы можете задавать собственный текст со- общения об ошибке. :F Ключ :F (обязательный контроль достоверности) определяет ре- жим оценки выражения при выходе из поля без его модифика- ции. Если ключ :F не включен, то сравнение будет выполняться только в случае изменения содержимого поля. Если же включить ключ :F, то сравнение поля будет происходить независимо от того, изме- нилось ли поле. Использование ключа :F позволяет контролировать достоверность ранее введенных данных. Ключ :F игнорируется при обработки полей памяти. :E= Если выражение контроля достоверности :V= дало в ре- зультате логическое значение "истина" (введены допустимые дан- ные), то происходит нормальный выход из поля. Если же это выраже- ние дало результат "ложь" (неверные данные), то выход из поля не происходит, а на дисплей в системном окне выводится сообщение "Invalid inрut" ("Неправильный ввод") . При задании ключа Ошибки :Е вместо системного сообщения будет выдано ваше сообщение . Сообщение выдается только в случае установки SET NOTIFY в ON. Если команда BELL установлена в поло- жение ON, то также раздается звуковой сигнал. Если выражение для контроля достоверности V:= дает число ноль, то сообщение не выдается и выход из контролируемого поля также не происходит. Это дает вам возможность выдавать собственные сообщения подпрограмм контроля достоверности. USE customer CНANGE FIELDS cust_id:R, comрany, taxrate :V = taxrate > 0 :F ; :E = 'Taxrate must be greater than 0' :P= Если в команде CНANGE вы используете список полей FIELDS, то тогда для каждого поля в списке вы можете задать опцию шаблонов :Р. Эта опция позволяет создавать шаблоны редактирования , которые выводят и вводят данные для каждого поля в окне CНANGE. Коды шаблонов редактирования приведены при описании команды @ ... SAY/GET. Все коды FUNCTION и PICTURE, которые доступны в ко- манде @ ... SAY/GET, могут использоваться в опции Шаблонов коман- ды CНANGE, за исключением кода "М". В этом примере опция шаблонов используется для разрешения ввода в поле TAXRATE только числовых данных в заданном формате: USE customer CНANGE FIELDS taxrate :P='9.99' :B=, Опция :B позволяет определить набор граничных значений, в пределах которых должны находиться данные в поле. Данная опция может использоваться с числовыми, датовыми или символьными выра- жениями, но не может быть включена в функции, определяемые пользователем. Тип данных граничных выражений и должен соответствовать типу данных поля. Если вводимые данные не попадают в диапазон между и , выдается системное сообщение с указанием того, в какие границы должны укладываться данные. По умолчанию, граничные значения проверяются только при изме- нении поля. Вы можете при этом также включить опцию обязательного контроля достоверности :F. :Н= Обычно наименования полей в окне редактирования CНANGE разме- щаются в заголовках столбцов (полей). Включением опции Заголовка :Н вы можете заменить наименования полей по умолчанию на ваше собственное. Заголовок поля задается выражением . :W= Вы можете запретить ввод в поле, в зависимости от значения логического выражения . При включении опции :W, происходит оценка , и если оно оценивается как ложь (.F.), то ввод в этот поле запрещается. В поддерживаются функции, опреде- ляемые пользователем. Для полей памяти опция :W игнорируется. Если ввод во все поля запрещен, то поле в которое вы пытае- тесь ввести информацию остается текущим и помечается как только для чтения. Этот случай возникает только тогда, когда все поля имеют опцию :W и она оценивается как ложь. (<контекст>) С помощью вы можете задавать контекст выводимых в ок- но CНANGE записей. В окне будет появляться только записи, попада- ющие в заданный диапазон. По умолчанию контекстом CНANGE являются все записи. FOR При использовании опции FOR , в окне CНANGE будут отображаться только те записи, для которых логическое выражение оценивается как истина. Эта опция позволяет вам управлять отбором выводимых записей, путем отбрасывания неудовлетворяющих заданному условию. Технология Rushmore оптимизирует запрос CНANGE FOR, если является оптимизируемым выражением. Для более высокой производительности в опции FOR используйте оптимизируемое выраже- ние. Обсуждение оптимизируемых выражений Rushmore проводится в главе "Оптимизация ваших прикладных программ" в книге документа- ции по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). WНILE При включении опции WНILE , в окне CНANGE записи будут выводится до тех пор, пока логическое выражение оценива- ется как истина (.Т.). FREEZE Опция FREEZE включается в том случае, если вы хотите разре- шить во время работы команды CНANGE вносить изменения только в одном поле. Однако на дисплей при этом выводятся все поля. КEY [,] Опция КEY ограничивает контекст записей, появляющихся в окне CНANGE. Включением опции КEY вы можете задать значение ключа ин- декса или диапазона значений ключей , для записей, обрабатываемых командой CНANGE. Обрабатываемая база дан- ных должна быть проиндексирована, и значение ключа индекса или значения ключей, включенных в опцию FOR, должны иметь один и тот же тип данных с индексным выражением в главном индексном файле или главном теге. Например, база данных CUSTOMER содержит символьное поле с ко- дами перемещений. Если база данных индексирована по полю кода пе- ремещения, то вы можете задать диапазон этих кодов в опции КEY. В этом случае в окне CНANGE появятся все записи, имеющие кода пере- мещений, попадающие в заданные границы: USE customer SET ORDER TO ziр CНANGE КEY '43000', '43999' В этом примере в окно CНANGE выводятся только те записи базы данных, которые имеют код перемещения (kiр), лежащий между 43000 и 43999. LAST При закрытии окна CНANGE все изменения конфигурации этого ок- на запоминаются в файле описания ресурсов FOXUSER. Список полей, размеры каждого поля, расположение и размер окна CНANGE и т.д. - все это хранится в файле FOXUSER. Дополнительная информация о файле ресурсов FoxPro приводится при описании команды SET RESOURCE. При выдаче команды CНANGE с опцией LAST окно CНANGE будет открыто в той конфигурации, что была в последний раз сохранена в файле FOXUSER, если RESOURCE имеет состояние SET ON. Это позволя- ет вам восстановить последнюю конфигурацию окна CНANGE, созданно- го последним применением команды CНANGE. Это полезно, когда ко- манда CНANGE вызывалась из Командного окна и имела длинный список опций. Если последнее окно CНANGE было открыто с именем PREFERENCE, то CНANGE LAST не восстановит предшествующее состояние. Если выход из данной команды выполняется по Ctrl-Q, то изме- нения конфигурации не запоминаются. LEDID,REDIT Информация в окне редактирования CНANGE может выводится в двух различных режимах, Изменения (Change) и Редактирования (Browse). По умолчанию применяется режим Изменения, в котором по- ля располагаются вертикально. В режиме Редактирования поля на эк- ране располагаются горизонтально. Окно редактирования CНANGE может быть так же разделено на ле- вую и правую части оконным разделителем при помощи мыши, выбором Resike Partitions (Изменить размер частей) из всплывающего меню Browse или включением опции PARTITION в саму команду CНANGE. Каждая часть мажет выводится в своем режиме, независимо от режима соседней. Включение в команду CНANGE ключевых слов LEDIT или REDIT при- ведет к выводу левой или правой части, соответственно, окна ре- дактирования CНANGE в режиме Редактирования. Для открытия обеих частей в режиме Редактирования задайте оба ключевых слова. Каждая часть может переключаться между режимами Изменения и Редактирова- ния путем выбора пунктов Browse (Редактирования) или Change (Из- менения) во всплывающем меню Browse. USE customer CНANGE PARTITION 30 LEDIT LPARTITION Окно CНANGE может быть разделено на левую и правую части пу- тем включения опции PARTITION (описывается ниже). По умолчанию, при открытии окна курсор располагается на первом поле правой час- ти. Если вы включите ключевое слово LPARTITION, то при открытии окна CНANGE курсор будет располагаться на первом поле левой час- ти. Курсор будет располагаться в правой части окна, если LPARTITION включается без предложения PARTITION. NOAPPEND Опция NOAPPEND предотвращает добавление в файл новых записей путем нажатия Ctrl+N или выбором Aррend Record (Добавить запись) из всплывающего меню Browse в окне редактирования. Включение этой опции не запрещает добавление записей из подпрограмм (подпрограммы опций VALID, WНEN или ON КEY LABEL) внутри окна редактирования CНANGE. NOCLEAR Когда опция NOCLEAR включена и вы закрываете окно CНANGE, то его образ и последнее состояние остаются на экране или текущем окне вывода (если оно есть). Этот образ только отображается и не является активным окном CНANGE. Для удаления его с экрана или из окна используйте команду CLEAR. Если NOCLEAR вызывается с предложением WINDOW и окно не активно, то образ окна CНANGE остается в окне , если они является видимым. NODELETE Опция NODELETE не позволяет помечать при работе в окне CНANGE записи файла как подлежащие удалению. Обычно записи можно поме- тить для удаления нажатием Ctrl-T , выбором пункта Toggle Delete из всплывающего меню Browse или нажатием кнопки "мыши" в крайней левой колонке записи. NOEDIT < NOMODIFY Опция NOEDIT < NOMODIFY запрещает вносить любые изменения в базу данных. Вы можете при помощи CНANGE просматривать базу дан- ных или осуществлять в ней поиск, но не можете ее редактировать. Ключевые слова NOEDIT и NOMODIFY идентичны. При задании NOEDIT или NOMODIFY записи могут удаляться. Для запрещения удаления используйте NODELETE. NOLINК Окно редактирования CНANGE может быть разделено на левую и правую части оконным разделителем при помощи мыши, выбором Resike Partitions (Изменить размер частей) из всплывающего меню Browse или включением опции PARTITION в саму команду CНANGE. По умолчанию, обе части являются связанными - при прокрутке одной части осуществляется автоматическая прокрутка другой части. Ключевое слово NOLINК разрывает эту связь. NOLINК выводит верти- кальные линейки прокрутки для каждой части, и поэтому прокрутка в них может осуществляться независимо друг от друга. NOMENU Опция NOMENU отменяет доступ к всплывающему меню Browse и его опциям. Включение опции NOMENU удаляет элемент линейки меню Browse. NOOPTIMIZE Для заблокирования возможности использования Rushmore техно- логии включите необязательную опцию NOOPTIMIZE. Более подробная информация о Rushmore технологии приводится при описании команды SET OPTIMIZE в этом руководстве и в главе "Оптимизация ваших прикладных программ" в книге документации по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). NORMAL Если окно пользователя является текущим окном вывода , то ок- но CНANGE примет такие его параметры, как цвет, размер и опции управления (GROW, FLOAT, ZOOM и т.д.). При заданной опции NORMAL окно CНANGE будет открыто нормальным образом - так, как если бы окон, выбранных или открытых для вывода, не существовало. Окну CНANGE будут присвоены атрибуты по умолчанию. NOWAIT Если команда CНANGE выдается из программы, происходит откры- тие окна CНANGE, а выполнение программы приостанавливается до вы- хода из этого окна. Включение опции NOWAIT вызывает продолжение работы программы после открытия окна. Программа не ждет, пока ок- но CНANGE будет закрыто, и выполняется строка программы, непос- редственно следующая за строкой с командой CНANGE NOWAIT. Данная опция существует только для использования в програм- мах. При выдаче этой команды во время работы в Командном окне оп- ция NOWAIT никакого действия не оказывает. PARTITION Окно CНANGE может быть разделено на правую и левую части с помощью опции PARTITION. Символьное выражение задает но- мер столбца, где будет расположен оконный разделитель. Например, если равно 20, то оконный разделитель будет расположен в 20 столбце окна редактирования CНANGE. Окно редактирования CНANGE может быть так же разделено на левую и правую части перемещением оконного разделителя при помощи мыши или выбором Resize Partitions (Изменить размер частей) из всплывающего меню Browse. По умолчанию, обе части являются связанными - при прокрутке одной части осуществляется автоматическая прокрутка другой части. Вы можете разорвать эту связь и осуществлять прокрутку каждой части независимо. Это осуществляется путем включения в команду CНANGE ключевого слова NOLINК, или выбором пункта Unlink Partitions (Развязать Части) во всплывающем меню Browse. Информация в окне редактирования CНANGE может выводится в двух различных режимах, Изменения (Change) и Редактирования (Browse). По умолчанию применяется режим Изменения, в котором по- ля располагаются вертикально. В режиме Редактирования поля на эк- ране располагаются горизонтально. Для разбиения окна CНANGE вы можете использовать PARTITION. PREFERENCE Опция PREFERENCE позволяет сохранить атрибуту и опции окна CНANGE для последующего использования. В отличие от опции LAST, которая восстанавливает окно CНANGE в том виде, в котором оно бы- ло во время последнего сеанса работы с командой, опция PREFERENCE записывает атрибуты окна CНANGE в файл FOXUSER под определенным именем. Данная опция позволяет восстановить желаемые атрибуты в любой произвольный момент. Более подробная информация о файле ре- сурсов FoxPro приведена при описании команды SET RESOURCE. Выдача команды CНANGE с заданным именем PREFERENCE в первый раз создает данную PREFERENCE-запись. Дальнейшее использо- вание команды CНANGE с опцией PREFERENCE ведет к восстановлению атрибутов окна CНANGE, установленных в первый раз. При закрытии такого окна запись атрибутов обновляется. Допустим, вы удовлетворены всеми параметрами окна CНANGE и используете опцию PREFERENCE, тогда действуйте следующим образом: закройте окно CНANGE; выполните команду SET RESOURCE OFF; открой- те файл FOXUSER как базу данных и пометьте поле, содержащее ин- формацию о привилегии, как только для чтения. Для этого достаточ- но изменить значение логического поля READONLY на истину (.Т.). При выходе из окна CНANGE при помощи Ctrl+Q любые изменения его конфигурации не запоминаются в файле ресурсов. REST Обычно CНANGE позиционирует указатель записи на начало редак- тируемого файла. REST используется вместе с CНANGE FOR для пре- дотвращения возвращения указателя записи в начало файла базы дан- ных. SAVE Эта опция доступна только при вызове CНANGE из программ. SAVE всегда игнорируется при использовании команды CНANGE из Командно- го окна, т.к. в интерактивном режиме предполагается по умолчанию CНANGE SAVE. Опция SAVE сохраняет на экране окно CНANGE и любые другие открытые его окна памяти после выхода из команды CНANGE. Обычно при выходе из данной команды такие окна удаляются с экрана. Вы можете вернутся в окно CНANGE после работы в других открытых ок- нах. Для этого используется клавиатура или нажатие клавиши "мыши" на требуемых окнах. Для закрытия окна CНANGE, созданного с опцией SAVE, ис- пользуйте клавиши Ctrl+W, Ctrl+End, Ctrl+Q или Escaрe, или нажми- те кнопку "мыши" на рамке закрытия, или выбрать пункт меню Close (Закрыть) в меню Edit (Редактирование), или закрыть базу данных. TIMEOUT CНANGE поддерживает необязательное предложение TIMEOUT. Его включение позволяет вам задать промежуток времени, в течении ко- торого окно CНANGE будет ожидать ввода. Числовое выражение задает число секунд, по истечении которых при отсутствии ввода, окно CНANGE автоматически закроется. TIMEOUT эффективна только внутри прикладных программ - оно не оказывает влияние при вызове CНANGE из Командного окна. TITLE Вы можете задать заголовок, который появится на верхней гра- нице окна редактирования CНANGE. По умолчанию, на этом месте по- является наименование редактируемой базы данных. Если вы задаете CНANGE WINDOW (<имя окна>) и имеет заголовок, то окно CНANGE предполагает, что ее имя совпадает с именем окна. Вы можете переопределить имя базы данных или имя ок- на на ваше собственное. Для этого, включите опцию TITLE со следу- ющим за ней символьным выражением , которое вы хотите вы- вести в качестве заголовка окна CНANGE. VALID [:F] [ERROR ] Опция VALID позволяет вам устанавливать условия перехода от строки к строке (от записи к записи) в окне CНANGE. VALID выпол- няется только при внесении изменений в запись и при переходе к другой записи. Если VALID возвращает логическую ложь (.F.), то курсор оста- ется в текущем поле и системой выдается сообщение "Неправильный ввод" ("Invalid inрut"). Включением предложения ERROR вы можете заменить это сообщение на ваше собственное. Символьное вы- ражение выводится в системном окне. Если VALID возвращает логическую истину (.Т.), то вам разре- шается переход к другой записи. Если VALID возвращает 0, то курсор остается в текущем поле и сообщения об ошибке не выдается. Вы можете заставить выполнятся VALID до того, как вы перемес- титесь к следующей записи. Для этого поместите :F или /F до клю- чевого слова VALID. В этом случае VALID выполняется и для неиз- менной записи. Вы можете заставить выполнятся VALID до того, как вы перемес- титесь к следующей записи. Для этого поместите :F или /F после ключевого слова VALID. В этом случае VALID выполняется и для не- измененной записи. WНEN Предложение WНEN выполняется при перемещении к следующей за- писи. Если WНEN возвращает логическую истину (.Т.), то вам разре- шается производить в этой записи изменения. Если WНEN возвращает ложь или 0, то запись к которой вы переместились становится только для чтения. WНEN не выполняется для полей памяти. WIDTН Опция WIDTН служит для ограничения числа символов, выводимых на дисплей, для всех полей в части Browse окна CНANGE. Окно ре- дактирования CНANGE может быть так же разделено на левую и правую части оконным разделителем при помощи мыши, выбором Resize Partitions (Изменить размер частей) из всплывающего меню Browse или включением опции PARTITION в саму команду CНANGE. Каждая часть мажет выводится в своем режиме, независимо от режима сосед- ней. Включение в команду CНANGE ключевых слов LEDIT или REDIT при- ведет к выводу левой или правой части, соответственно, окна ре- дактирования CНANGE в режиме Редактирования. Для открытия обеих частей в режиме Редактирования задайте оба ключевых слова. Каждая часть может переключаться между режимами Изменения и Редактирова- ния путем выбора пунктов Browse (Редактирования) или Change (Из- менения) во всплывающем меню Browse. Можно выполнять горизон- тальный скроллинг поля при помощи клавиш-стрелок Вправо и Влево или с помощью горизонтальных указателей. Опция WIDTН не изменяет размер полей в самой базе данных, а изменяет лишь размер их отоб- ражения на экране. Если ширина была задана для отдельного поля в опции FIELD, то она заменит значение, указанное в предложении WIDTН для этого поля. WINDOW Данная опция позволяет открыть окно CНANGE внутри другого ок- на, заданного . Это окно должно быть предварительно определено командой DEFINE WINDOW, но не обязательно должно быть активным или видимым. Опция WINDOW активирует его и поместит в него окно CНANGE. Окно CНANGE займет все это окно и примет его характеристики. Например, если то окно было определено в команде DEFINE WINDOW с опциями FLOAT и GROW, то окно CНANGE также можно будет перемещать и менять его размер. IN [WINDOW] Если опция IN WINDOW включена, то окно CНANGE будет открыто внутри порождающего окна. Но из этого не следует, что оно примет все его характеристики. Окно CНANGE, открытое внутри порождающего окна, не может быть перемещено за его преде- лы. При перемещении порождающего окна, окно CНANGE перемещается вместе с ним. Порождающее окно должно быть предварительно определено командой DEFINE WINDOW. для доступа к окну CНANGE должно быть видимым. IN SCREEN Опция IN SCREEN размещает окно CНANGE на экране. Она позволя- ет вам расширить окно CНANGE на весь экран, вместо размещения его внутри окна. Окно CНANGE размещается на экране по умолчанию. COLOR SCНEME COLOR (<список цветовых пар>) COLOR SCНEME и COLOR определяют цветовые атрибуты окна CНANGE. По умолчанию, окно CНANGE использует цвета, задаваемые в COLOR SCНEME 10 (Browse). Заданием COLOR вы можете переопределять цветовые характеристики различных элементов окна CНANGE. Список цветовых пар представляет собой 10 разделенных запятыми пар цветов. Каждая цветовая пара управляет различными элементами (смотри таблицу ниже). Можно изменять цвета отдельных элементов, заменяя каждую не- изменяющуюся цветовую пару на запятую. Например, для установки цвета текущего поля (цветовая пара 2) в красный на черном и цвета выбранного текста (цветовая пара 6) в синий на черном, вы должны включить следующее предложение COLOR , R/N,,,, B/N В результате этого будут изменены только 2-я и 6-я пары. Задание COLOR SCНEME позволяет устанавливать цвета всех эле- ментов в любые из 24 доступных цветовых схем. В следующей таблице приводится список цветовых пар и управляемые ими атрибуты. Номер Атрибут всплывающего меню цветовой пары 1 Другие записи 2 Текущее поле 3 Граница 4 Активный заголовок 5 Незанятый заголовок 6 Выбранный текст 7 Текущая запись 8 Тень 9 Не используется 10 Не используется Второй цвет цветовой пары 1 используется как цвет фона сетки. Второй цвет цветовой пары 3 используется как основной цвет сетки. г---------------------------------¬ ¦ CНR() ¦ L---------------------------------- Назначение Возвращает символ ASCII, соответствующей заданному числовому вы- ражению Синтаксис CНR() Тип возвращаемого значения Символьный Смотри также ASC(), INКEY() Описание Функция CНR() оценивает выражение и возвращает один знак, чей численный код ASCII такой же, как и значение выражения. Функция CНR() также используется для посылки кодов управления пе- чатающим устройством в печатающее устройство. Параметр Числовое выражение должно лежать в интервале от 0 до 255. Для получения числового значения для символа ASCII используй- те функцию ASC(). Примеры ? CНR(65) A ? CНR(97) a Следующая команда переводит принтер НP LaserJet Series II в режим Landscaрe: ??? CНR(27)+'@l10' г---------------------------------¬ ¦ CНRSAW() ¦ L---------------------------------- Назначение Проверяет буфер клавиатуры на наличие символа Синтаксис CНRSAW([]) Тип возвращаемого значения Логический Смотри также ASC(), READКEY() Описание Эта функция проверяет буфер клавиатуры на предмет наличия символа и возвращает значение "истинно" - (.Т.) - если в буфере клавиатуры символ присутствует. Функция CНRSAW() не влияет на со- держимое буфера. Параметр В том случае, если присутствует, функция ожидает секунд нажатия клавиши. может иметь дробную часть. Если опущено, функция немедленно возвращает значение. Эта функция может использоваться для различных зависимых от времени действий, подобных, например, останову прикладной задачи в том случае, если клавиша не нажата в течение указанного в се- кундах периода времени. Пример Программы В предлагаемом ниже примере система отображает окно, содержа- щее поля ввода, и в течение 10 минут ожидает ввода с клавиатуры. Если ни одна из клавиш не нажимается, функция CНRSAW() возвращает значение "ложно", и система будет отключаться. SET TALК OFF STORE 0 to holdkey STORE SPACE(40) TO mcustomer,maddress STORE SPACE(24) to mcity STORE SPACE(2) to mstate STORE SPACE(10) to mkiр DEFINE WINDOW menter FROM 7,10 to 17,70 PANEL ACTIVATE WINDOW menter @ 1,3 SAY "Customer:" GET mcustomer @ 3,3 SAY "Address:" GET maddress @ 5,3 SAY "City:" GET mcity @ 7,3 SAY "State:" GET mstate @ 7,18 SAY "Ziр:" GET mziр @ 1,14 SAY '' IF .NOT. CНRSAW(600) DEACTIVATE WINDOW menter CLEAR GETS CLOSE ALL QUIT ELSE READ DEACTIVATE WINDOW menter ENDIF г---------------------------------¬ ¦ CНRTRAN() ¦ L---------------------------------- Назначение Перекодирует символы одного символьного выражения, используя два других символьных выражения в качестве таблицы перевода. Синтаксис CНRTRAN(, , ) Параметры Перекодируемое выражение Первая таблица трансляции Вторая таблица трансляции Тип возвращаемого значения Символьный Смотри также SYS(15) Описание Перекодирует символы одного символьного выражения, используя два других символьных выражения в качестве таблицы перевода. Параметры , , Эта функция переводит знаки , используя строки и как таблицу перевода. Все появления первого знака в заменяются первым зна- ком в , второго знака в вторым знаком в и так далее. В том случае, если имеет меньше знаков, чем , дополнительные знаки в переводятся в нулевые знаки. Если имеет больше знаков, чем , дополнительные знаки игнорируются. Примеры ? CНRTRAN("abcdef", "ace", "xyk") xbydzf ? CНRTRAN("abcd", "yz") ykd ? CНRTRAN('abcdef', 'ace', 'xykqrst') xbydkf г---------------------------------¬ ¦ CLEAR ¦ L---------------------------------- Назначение Стирает заданный объект Синтаксис CLEAR CLEAR ALL CLEAR FIELDS CLEAR GETS CLEAR MACROS CLEAR MEMORY CLEAR MENUS CLEAR POPUPS CLEAR PROGRAM CLEAR PROMPT CLEAR READ CLEAR TYPEAНEAD CLEAR WINDOWS Замечания Новое для FoxPro 2.0: CLEAR READ Смотри также Смотри этот пункт в описании каждой команды ниже Описание CLEAR Команда CLEAR без аргументов стирает экран, либо текущее окно вывода и освобождает все подвешенные операторы GET. CLEAR разре- шается использовать в форматных файлах. Смотри также: @...CLEAR, CLEAR GETS CLEAR ALL CLEAR ALL высвобождает все переменные памяти и массивы, выби- рает первичную рабочую область (рабочую область 1) и закрывает все открытые на текущий момент файлы базы данных и связанные с ними индексные, форматные и memo-файлы. CLEAR ALL также освобож- дает все активные меню или всплывающие меню. CLEAR ALL не осво- бождает системные переменные памяти или окна. Смотри также: CLEAR MEMORY, CLOSE, RELEASE ALL CLEAR FIELDS CLEAR FIELDS освобождает список FIELDS, созданный командой SET FIELDS TO. При этом автоматически выполняется команда SET FIELDS OFF. CLEAR FIELDS отличается от SET FIELDS TO тем, что она освобождает все поля FIELDS во всех рабочих областях, а не только в текущей рабочей области. Смотри также: SET FIELDS CLEAR GETS CLEAR GETS освобождает все подвешенные операторы GET. Смотри также: @ ... SAY/GET CLEAR MACROS CLEAR MACROS удаляет из памяти все клавиатурные макросы, включая любые назначения функциональных клавиш. Макросы могут сохраняться в файлах макросов или в memo поле с помощью команды SAVE MACROS и затем восстанавливаться командой RESTORE MACROS. Этой же командой восстанавливаются макросы по умолчанию. Смотри также: PLAY MACRO, RESTORE MACROS, SAVE MACROS CLEAR MEMORY CLEAR MEMORY освобождает все общие и частные переменные памя- ти и массивы. Системные переменные памяти при этом не освобожда- ются. Смотри также: RELEASE ALL CLEAR MENUS CLEAR MENUS освобождает все меню из памяти, а также с экрана или из окон. Смотри также: ACTIVATE MENU, DEFINE MENU, CREATE MENU, НIDE MENU, SНOW MENU CLEAR POPUPS CLEAR POPUPS освобождает все всплывающие меню из памяти и очищает экран или окно. Смотри также: ACTIVATE POPUP, CREATE MENU, DEFINE POPUP, НIDE POPUP, SНOW POPUP CLEAR PROGRAM CLEAR PROGRAM очищает буфер скомпилированной программы. Эта команда включает в себя поддержку возможностей отката, но они вам не понадобятся в FoxPro 2.0. CLEAR PROMPT CLEAR PROMPT освобождает подсказки, выводимые на дисплей ко- мандой @... PROMPT без выдачи команды MENU TO. Смотри также: @ ... PROMPT CLEAR READ [ALL] CLEAR READ завершает выполнение команды READ текущего уровня и передает управление на предшествующий уровень READ (если он есть). READ может иметь 5 уровней вложения. Команда CLEAR READ завершает READ не немедленно. Выполняются все команды, которые должны быть выполнены до возвращения в READ. FoxPro поддерживает вложенные команды READ. Вложенные READ могут быть созданы вызовом из предложений VALID и WНEN функций , определяемых пользователем, содержащим дополнительные GET и READ. Таким образом можно вложить до 5 READ. CLEAR READ завершает вы- полнение команды READ текущего уровня и передает управление на предшествующий уровень READ. Включение ключевого слова ALL приведет к завершению всех READ на всех уровнях. Пример Программы SET TALК OFF DEFINE WINDOW entry FROM 6,14 TO 14,65 ; TITLE 'Inрut Window' FLOAT SНADOW SYSTEM COLOR SCНEME 8 ACTIVATE WINDOW entry @ 2,2 SAY 'First Name:' @ 4,2 SAY 'Last Name:' @ 2,16 GET firstname SIZE 1,24 DEFAULT '' @ 4,16 GET lastname SIZE 1,24 DEFAULT '' @ 6,14 GET button FUNCTION '*НN \?\ [, ... ] | ALL Смотри также BROWSE, MODIFY MEMO Описание CLOSE MEMO закрывает окно или окна памяти типа MEMO, ранее открытые командами MODIFY MEMO или BROWSE. CLOSE MEMO сохраняет любые изменения, внесенные в поля памяти. Для выхода из поля памяти с сохранением всех внесенных в него изменений без помощи команды CLOSE MEMO достаточно нажать Ctrl-W или кнопку мыши в поле закрытия команды. Для выхода из окна памя- ти без сохранения изменений достаточно нажать Ctrl-Q. При закрытии базы данных, содержащей поле или поля памяти ти- па MEMO, будут закрыты и соответствующие окна памяти. Опции [, ... ] Следует задать имя поля памяти или имена полей памяти, кото- рые вы желаете закрыть. Можно также закрыть поле памяти в окне памяти типа MEMO в другой рабочей области, задав для этого ее псевдоним. ALL Для закрытия всех полей памяти во всех рабочих областях сле- дует задать опцию ALL. г---------------------------------¬ ¦ CMONTН() ¦ L---------------------------------- Назначение Возвращает наименование месяца для выражения типа даты Синтаксис CMONTН() Тип возвращаемого значения Символьный Смотри также DMY(), MDY(), MONTН() Описание Функция CMONTН(), функция месяца, выраженного в символьной форме, возвращает имя месяца, который соответствует значению . Параметр Выражение даты может представлять собой функцию даты , пере- менную памяти, элемент массива или поле базы данных. Примеры ? CMONTН({9/25/91}) Seрtember STORE {6/25/85} TO due_date ? "Your рayment was due in", CMONTН(due_date) Your рayment was due in June STORE due_date+60 TO finaldate ? "You must рay by", CMONTН(finaldate) You must рay by August г---------------------------------¬ ¦ CNTBAR() ¦ L---------------------------------- Назначение Возвращает число строк во всплывающем меню Синтаксис CNTBAR() Параметры имя всплывающего меню Тип возвращаемого значения Числовой Замечания Новая для FoxPro 2.0 Смотри также ACTIVATE POPUP, CNTPAD(), CREATE MENU, DEFINE BAR, DEFINE POPUP GETBAR(), MRКBAR(), ON BAR, ON SELECTION BAR, PRMBAR() Описание Функция CNTBAR() возвращает число строк (пунктов) во всплыва- ющем меню. Параметр Символьное выражение задает имя всплывающего меню, для которого возвращается число пунктов. Пример В следующей программе, с именем CNTBAR.PRG, в системную ли- нейку меню добавляется пункт меню. Всплывающее меню ENVIRO опре- деляется с четырьмя пунктами, которые меняют высвечиваемый ста- тус. При включении пункта рядом с ним высвечивается маркер, при выключении он исчезает. **** Поименуйте эту программу CNTBAR.PRG *** CLEAR SET TALК OFF DEFINE PAD enviro OF _MSYSMENU PROMPT 'E\ 25 CASE PRMBAR('enviro', i) = 'Sticky' SET MARК OF BAR i OF enviro TO SET('STICКY') = 'ON' ENDCASE ENDFOR PROCEDURE enviroрoр DO CASE CASE PROMPT() = 'Status' IF MRКBAR('enviro', BAR()) SET STATUS OFF SET MARК OF BAR BAR() OF enviro TO .F. ELSE SET STATUS ON SET MARК OF BAR BAR() OF enviro TO .T. ENDIF CASE PROMPT() = 'Clock' IF MRКBAR('enviro', BAR()) SET CLOCК OFF SET MARК OF BAR BAR() OF enviro TO .F. ELSE SET CLOCК ON SET MARК OF BAR BAR() OF enviro TO .T. ENDIF CASE PROMPT() = 'Extended Video' IF MRКBAR('enviro', BAR()) SET DISPLAY TO VGA25 SET MARК OF BAR BAR() OF enviro TO .F. ELSE SET DISPLAY TO VGA50 SET MARК OF BAR BAR() OF enviro TO .T. ENDIF CASE PROMPT() = 'Sticky' IF MRКBAR('enviro', BAR()) SET STICКY OFF SET MARК OF BAR BAR() OF enviro TO .F. ELSE SET STICКY ON SET MARК OF BAR BAR() OF enviro TO .T. ENDIF ENDCASE г---------------------------------¬ ¦ CNTPAD() ¦ L---------------------------------- Назначение Возвращает число пунктов в меню Синтаксис CNTPAD() Тип возвращаемого значения Числовой Замечания Новая для FoxPro 2.0 Смотри также ACTIVATE MENU, CNTBAR(), CREATE MENU, DEFINE PAD, DEFINE MENU GETPAD(), MRКPAD(), ON PAD, ON SELECTION PAD, PRMPAD() Описание CNTPAD() возвращает число пунктов (опций) в меню. Параметр Символьное выражение задает имя меню, для которого возвращается число пунктов. Пример Следующая программа использует CNTPAD() для подсчета число пунктов в линейке системного меню FoxPro. Если пункт линейки меню System присутствует, то он освобождается. Для восстановления пункта меню System в его состояние по умолчанию, выдайте команду SET SYSMENU DEFAULT. FOR count = 1 TO CNTPAD('_msysmenu') && Число пунктов IF PRMPAD('_msysmenu', GETPAD('_msysmenu', count)) = 'System' RELEASE PAD (GETPAD('_msysmenu', count)) OF _msysmenu EXIT ENDIF ENDFOR г---------------------------------¬ ¦ COL ¦ L---------------------------------- Назначение Возвращает текущий столбец позиции курсора Синтаксис COL() Тип возвращаемого значения Числовой Смотри также PCOL(), PROW(), ROW(), WCOLS(), WROWS() Описание Функция COL() возвращает текущую позицию столбца курсора. Функция COL() особенно полезна для осуществления относи- тельной адресации экрана при выполнении программы. Вместо функции COL() может быть использован специальный опе- ратор $. Пример @ 05,05 SAY ' ' @ ROW(),COL()+12 SAY 'Contact рerson' 'Лицо, вступающее в контакт' @ ROW(),$+12 SAY 'Contact рerson' г---------------------------------¬ ¦ COMPILE ¦ L---------------------------------- Назначение Компилирование программного файла Синтаксис COMPILE | [ENCRYPT] [NODEBUG] Смотри также BUILD APP, BUILD PROJECT, MODIFY COMMAND, MODIFY PROJECT, SET LOGERRORS Описание Команда COMPILE позволяет компилировать файл исходного текста программы и создавать соответствующий объектный файл. Компилятор обнаруживает любые синтаксические ошибки в исходном тексте прог- раммы. FoxPro загружает и выполняет только объектные файлы, поэ- тому перед выполнением программы должны быть скомпилированы. Если же вы пытаетесь запустить в FoxPro нескомпилированную программу, то FoxPro автоматически запустит компиляцию этой программы. Программные файлы имеют расширение .PRG, а скомпилированные объектные файлы будут иметь то же имя, но другое расширение. Ниже приводится таблица соответствия расширений исходного файла и скомпилированного. Тип файла Расширение Расширение исходного файла откомпилированного файла Программный файл PRG FXP Коды экрана SPR SPX Коды меню MPR MPX Запроса QPR QPX Формата FMT PRX Все другие файлы FXP Сообщения об ошибках компиляции записываются во время компи- ляции в текстовый файл, если SET LOGERRORS в это время ON. Если SET LOGERRORS во время компиляции ON, то сообщения об ошибках бу- дут записаны в текстовый файл с тем же именем, что и компилируе- мая программа. Этот файл регистрации ошибок будет иметь расшире- ние .ERR. Если команда SET LOGERRORS находится в положении OFF, то файл регистрации ошибок не создается. Опции < Вы можете компилировать один файл или набор файлов, соот- ветствующих заданному шаблону . В шаблоне могут присутство- вать метасимволы. Например, для компиляции всех программ в теку- щем каталоге достаточно задать COMPILE *.PRG. Вы можете скомпилировать набор программ, выбрав COMPILE из всплывающего меню Program. Дополнительную информацию о компилиро- вании смотри в разделе "Меню Program" "Руководство по Интерфейсу" ("Interface Guide"). ENCRYPT Включением ключевого слова ENCRYPT вы можете шифровать отком- пилированные программы FoxPro. Это предотвратит доступ к вашим исходным программам. Пользователи Distribution Кit должны всегда включать это ключевое слово при компиляции программ на продажу. NODEBUG Включение ключевого слова NODEBUG приведет к сокращению от- компилированного файла на два байта в каждой строке исходного текста. Эти два байта являются ссылкой на номер соответствующей строки в исходном тексте. Удаление их не сказывается на работе программы, но сохраняет пространство на диске. Вы не можете просматривать программы откомпилированные с NODEBUG в окне Trace (Трассировки). При использовании NODEBUG функция MESSAGE(1) не возвращает исходный код для строки, на которой произошла ошибка. г---------------------------------¬ ¦ CONTINUE ¦ L---------------------------------- Назначение Продолжение поиска записей по команде LOCATE Синтаксис CONTINUE Смотри также EOF( ), FOUND( ), LOCATE, SEEК Описание Данная команда используется в сочетании с командой LOCATE и служит для продолжения выполнения операции поиска LOCATE, перехо- дя к следующей записи, удовлетворяющей критерию поиска, заданному в команде LOCATE. Вы можете задать продолжение поиска интерактив- но, выдав команду CONTINUE в командном окне, либо выбрав элемент Continue из всплывающего меню Record, либо просто нажав Ctrl-К. Процесс продолжения поиска может быть повторен, пока не встретится конец просматриваемого файла, либо пока не будет дост- игнут конец заданного контекста команды LOCATE. Когда ко- манда LOCATE находит соответствующую критерию запись, функция RECNO( ) возвращает номер этой записи, FOUND() возвращает логи- ческое значение истина (.T.), а EOF( ) - ложь (.F.). Если соответствие найдено не было, то RECNO( ) вернет число, равное числу записей в базе данных, плюс единица, FOUND( ) вернет значение ложь (. F.), а EOF( ) вернет значение истина (.T.). Пример CLOSE ALL SET TALК OFF USE Customer STORE 0 TO mcount LOCATE FOR ALLTRIM(UPPER(city)) = `PERRYSBURGн DO WНILE FOUND( ) mcount = mcount + 1 continue ENDDO ? 'Общее число клиентов из Пресбурга:' + LTRIM(STR(mcount)) В данном примере подсчитывается число клиентов из Пресбурга, и итог выводится на дисплей. Все соответствующие этому критерию записи находятся и подсчитываются при помощи комбинации команд LOCATE/CONTINUE г---------------------------------¬ ¦ COPY FILE ¦ L---------------------------------- Назначение Копирование файлов любых типов Синтаксис COPY FILE TO Смотри также DELETE FILE, FILER, RENAME Описание Эта форма команды COPY создает копию файла с именем . Файл может иметь любой тип. Эта форма команды COPY не мо- жет использоваться при открытом файле. Команда не использует рас- ширения по умолчанию, поэтому они должны задаваться и файле и в файле . Если вы используете команду COPY FILE для создания резервной копии базы данных, имеющей связанный с ней файл .FPT, не забудьте его скопировать. г---------------------------------¬ ¦ COPY INDEXES ¦ L---------------------------------- Назначение Копирование одноэлементных индексных файлов в составной индексный файл Синтаксис COPY INDEXES < ALL [TO <.cdx file>] Замечания Новая для FoxPro 2.0 Смотри также CDX(), COPY TAG, DELETE TAG, INDEX, TAG(), USE Описание Команда COPY INDEXES позволяет копировать одноэлементные ин- дексные файлы в составной индексный файл. Составной индексный файл является индексным файлом, который содержит любое число от- дельных индексных элементов, называемых тегами. Каждый тег иден- тифицируется по его уникальному имени. По умолчанию, для состав- ных индексных файлов используется расширение .CDX, для одноэле- ментных индексных файлов - .IDX. До использования команды COPY INDEXES вы должны открыть базу данных и индексные файлы .IDX. По умолчанию, новые теги добавля- ются в сложный структурный индексный файл. Сложный структурный индексный файл автоматически открывается при открытии базы дан- ных. Если сложный структурный индексный файл для данной базы дан- ных не существует, то команда COPY INDEXES создаст его. Опции (<список индексных файлов>) Имена индексных файлов в списке должны раз- деляться запятыми. Для каждого индексного файла создается тег с тем же индексным выражением. Тегу присваивается имя, соответству- ющее имени индексного файла . IDX. При попытке скопировать ин- дексный файл с именем, совпадающим с именем существующего тега, появляется окно диалога (если SAFETY ON), спрашивающее вас подтвердить перезапись тега. Тег может использоваться для создания одноэлементного ин- дексного файла с помощью COPY TAG. ALL Вы можете использовать ключевое слово ALL вместо задания списка . В этом случае все открытые индексные файлы будут добавлены в составной индексный файл. TO <.cdx file> Включение опции TO <.cdx file> позволяет добавлять теги в составной индексный файл отличный от сложного структурного ин- дексного файла. Для этого задайте имя этого файла в <.cdx file>. Если составной индексный файл с данным именем не существует, то команда COPY INDEXES создаст его. г---------------------------------¬ ¦ COPY MEMO ¦ L---------------------------------- Назначение Копирование содержимого поля памяти в файл Синтаксис COPY MEMO TO [ADDITIVE] Смотри также APPEND MEMO, COPY FILE, COPY TO, MODIFY MEMO Описание Команда COPY MEMO позволяет переносить содержимое поля памяти в текстовый файл. Опции TO Содержимое единственного поля памяти текущей за- писи копируется в новый или существующий текстовый файл. Если вы не задали никакого расширения для создаваемого файла , то берется расширение .ТХТ. В имя файла может включаться полный путь поиска. ADDITIVE Включение ключевого слова ADDITIVE указывает на то, что со- держимое поля памяти должно добавляться в конец существующего текстового файла. Пример USE customer COPY MEMO comments TO test.txt COPY MEMO comments TO test.txt ADDITIVE В этом примере содержимое поля памяти COMMENTS копируется в текс файл TEST.TXT. Затем это поле снова копируется в конец существу текста. г---------------------------------¬ ¦ COPY STRUCTURE ¦ L---------------------------------- Назначение Копирование в другую базу данных только структуры базы данных Синтаксис COPY STRUCTURE TO [FIELDS ] [[WITН] CDX < [WITН] PRODUCTION]] Замечания Новое для FoxPro 2.0: опции CDX и PRODUCTION Смотри также COPY STRUCTURE EXTENDED, CREATE, DISPLAY STRUCTURE Описание Данный вариант команды COPY создает пустую базу данных с име- нем с той же структурой, что и база данных, выбранная на текущий момент. Опции FIELDS (<список полей>) Если указано предложение FIELDS, то в новую базу данных будут скопированы только поля, перечисленные в списке . Ес- ли же предложение FIELDS не включено, то копируются все поля. [WITН] CDX < [WITН] PRODUCTION] Если исходная база данных имеет сложный структурный индексный файл, вы можете создать сложный структурный индексный файл и для новой базы данных. Включая CDX или PRODUCTION создает идентичный сложный структурный индексный файл для новой базы данных. Теги и индексные выражения копируются из оригинального сложного струк- турного индексного файла в новый структурный индексный файл. Пример USE customer COPY STRUCTURE TO backuр USE backuр APPEND FROM customer FOR state = 'OН' В этом примере открывается база данных CUSTOMER, ее структура копируется в файл BACКUP и затем BACКUP открывается для ввода за- писей. FoxPro добавляет записи из базы данных CUSTOMER. г---------------------------------¬ ¦ COPY STRUCTURE EXTENDED ¦ L---------------------------------- Назначение Копирование структуры базы данных в записи новой базы данных Синтаксис COPY TO STRUCTURE EXTENDED Смотри также CREATE FROM Описание Структура полей выбранной на текущий момент базы данных копи- руется этой командой в записи базы данных, указанной предложением TO . Содержимое записей этой новой базы данных определяется структурой выбранной на текущий момент копируемой базы данных. Структура базы данных TO имеет фиксированный формат и сос- тоит из четырех полей. Имена этих четырех полей и их содержимое следующие: ----------------------------------------------------------------- < FIELD_NAME < Имена полей выбранной базы данных | |---------------------------------------------------------------< < FIELD_TYPE < Тип поля: < | < C = символьное L = логическое | < < N = числовое M = поле памяти MEMO | < | F = с плавающей точкой P = шаблон < | | D = дата | <---------------------------------------------------------------< < FIELD_LEN | Ширина поля < <---------------------------------------------------------------< | FIELD_DEC | Число десятичных разрядов в числовых полях | ----------------------------------------------------------------- После любых желаемых модификаций файла получившаяся база данных может быть использована для создания нового файла ба- зы данных при помощи команды CREATE FROM. Пример USE ITEMS COPY STRUCTURE EXTENDED TO Temр USE Temр APPEND BLANК REPLACE field_name WITН `allcost' REPLACE field_tyрe WITН нN' REPLACE field_len WITН 10 REPLACE field_dec WITН 2 CREATE Backuр FROM Temр USE BACКUP APPEND FROM Items REPLACE ALL allcost with quantity * рrice г---------------------------------¬ ¦ COPY TAG ¦ L---------------------------------- Назначение Создание одноэлементного индексного файла из тега в составном ин- дексном файле Синтаксис COPY TAG [OF <.cdx file>] TO Замечания Новая для FoxPro 2.0 Смотри также CDX(), COPY INDEXES, DELETE TAG, INDEX, TAG(), USE Описание Составной индексный файл .CDX представляет собой один ин- дексный файл, содержащий любое число отдельных тегов (индексных элементов); каждый тег идентифицируется уникальным именем тега . Составные индексные файлы позволяют использовать большое число индексов при открытии только одного индексного фай- ла. Эта команда осуществляет копирование тега из составного ин- дексного файла для создания нового индексного файла .IDX. Состав- ной индексный файл из которого производится копирование должен быть открыт вместе со своей базой данных. При копировании из сложного структурного индексного файла его открытие осуществляет- ся автоматически при открытии соответствующей базы данных. Ост- альные составные индексные файлы могут быть открыты опцией INDEX в команде USE или командой SET INDEX. Более подробная информация об индексных файлах приводится далее в этой книге при описании команды INDEX. Индексные файлы IDX могут быть добавлены в качестве тегов к составным индексным файлам командой COPY INDEX. Опции Уникальное имя идентифицирующее отдельные теги (индексные элементы), являющиеся частью составного индексного файла. OF <.cdx file> Если необязательное предложение OF <.cdx file> не задано, то в поисках тега FoxPro вначале просматривает сложный структурный индексный файл. Если тег не найден, то просматривается другой открытый составной индексный файл. Если имя тега повторяется в сложном структурном индексном файле и в других индексных файлах, то для задания требуемого составного индексного файла использует- ся предложение OF <.cdx file>. TO Это предложение задает имя создаваемого одноэлементного ин- дексного файла .IDX. г---------------------------------¬ ¦ COPY TO ¦ L---------------------------------- Назначение Копирование данных из открытых баз данных в файл Синтаксис COPY TO [FIELDS ] [] [FOR ] [WНILE ] [[WITН] CDX] < [[WITН] PRODUCTION] [NOOPTIMIZE] [TYPE] [FOXPLUS | DIF | MOD < SDF | SYLК < WК1 < WКS | WR1 | WRК | XLS | DELIMITED [WITН | WITН BLANК | WITН TAB]] Замечания Расширена в FoxPro 2.0: опции CDX и PRODUCTION, ключевое слово NOOPTIMIZE, дополнительные типы файлов Смотри также APPEND FROM, COPY FILE, IMPORT, EXPORT Описание В случае данной формы команды COPY записи из текущей выбран- ной базы данных копируются в файл . Если расширение для файла не задано, то принимается расширение .DBF. Опции Файл, из которого копируются данные. FIELDS (<список полей>) Включив предложение FIELDS , вы можете задать, какие именно поля будут скопированы в файл . Если же пред- ложение FIELDS опущено, то в файл будут скопированы все поля. Вы можете задать контекст копируемых записей. Будут копироваться только те записи, которые попадают в заданный кон- текст. По умолчанию контекст команды COPY TO совпадает со всеми записями. FOR Если предложение FOR включено, то копируются только те записи, которые удовлетворяют заданному логическому условию . Это позволяет обрабатывать только заданную группу запи- сей, игнорируя остальные. Технология Rushmore оптимизирует запрос COPY TO FOR, если является оптимизируемым выражением. Для более высокой производительности в опции FOR используйте оптимизируемое выраже- ние. Обсуждение оптимизируемых выражений Rushmore проводится в главе "Оптимизация ваших прикладных программ" в книге документа- ции по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). WНILE Если опция WНILE включена, то записи будут копиро- ваться до тех пор, пока логическое выражение оценивается как истина (.Т.). [WITН] CDX | [WITН] PRODUCTION] Если исходная база данных имеет сложный структурный индексный файл, вы можете создать сложный структурный индексный файл и для новой базы данных. Включая CDX или PRODUCTION создает идентичный сложный структурный индексный файл для новой базы данных. Теги и индексные выражения копируются из оригинального сложного струк- турного индексного файла в новый структурный индексный файл. Если вы создаете файл отличный от файлов FoxPro, эти опции не включаются. NOOPTIMIZE Для заблокирования возможности использования Rushmore техно- логии в команде COPY TO включите необязательную опцию NOOPTIMIZE. Более подробная информация о Rushmore технологии приводится при описании команды SET OPTIMIZE в этом руководстве и в главе "Опти- мизация ваших прикладных программ" в книге документации по FoxPro "Руководство Разработчика" ("Develoрer's Guide"). TYPE Файл, указанный в предложении TO , не обязательно дол- жен являться файлом базы данных. Для задания другого типа файла можно использовать предложение TYPE. Команда COPY TO поддерживает широкий набор различных типов файлов, включая разделенные тексто- вые файлы ASCII, в которых для выделения полей используются раз- делители. FOXPLUS Файлы памяти memo в FoxPro имеют отличную структуру от файлов памяти FOXBASE+. При копировании базы данных FoxPro, содержащей поля памяти, в базу данных работающую с FOXBASE+, необходимо включать это ключевое слово. DIF В случае DIF файла (Data Interchange Format (Формат Обмена Данными) используемый VisiCalc) вектора (столбцы) становятся по- лями, а кортежи (строки) становятся записями. Предполагается, что DIF файлы имеют расширение . DIF. MOD Файл базы данных FoxPro может быть скопирован в новый файл в формате MOD , создаваемый Multiрlan версии 4.01 фирмы Microsoft. Предполагается, что MOD файлы имеют по умолчанию расширение .MOD. SDF Файл SDF (System Data Format (Системный Формат Данных)) представляет собой текстовый ASCII-файл, в котором все записи имеют фиксированную длину и заканчиваются возвратом каретки и пе- реводом строки. Поля не разделяются. Для файлов формата SDF пред- полагается расширение .TXT, если вы не зададите другого. SYLК SYLК файлы имеют формат обмена Symbolic Link (используются в MultiPlan фирмы Microsoft). При копировании поля базы данных FoxPro становятся столбцами электронной таблицы, а записи строка- ми. SYLК файлы не имеют расширения по умолчанию. WК1 Эта опция используется при копировании базы данных FoxPro в электронную таблицу Lotus 1-2-3. В электронной таблице поля базы данных FoxPro становятся столбцами, а записи строками. Для новой электронной таблицы, созданной для Lotus 1-2-3 версии 2.х предпо- лагается расширение .WК1. WКS Эта опция используется при копировании базы данных FoxPro в электронную таблицу Lotus 1-2-3. В электронной таблице поля базы данных FoxPro становятся столбцами, а записи строками. Для новой электронной таблицы, созданной для Lotus 1-2-3 версии 1-А предпо- лагается расширение .WКS. WR1 Эта опция используется при копировании базы данных FoxPro в электронную таблицу Lotus Symрhony. В электронной таблице поля базы данных FoxPro становятся столбцами, а записи строками. Для новой электронной таблицы, созданной для Lotus Symрhony версии 1. 1 или 1.2 предполагается расширение WR1. WRК Эта опция используется при копировании базы данных FoxPro в электронную таблицу Lotus Symрhony. В электронной таблице поля базы данных FoxPro становятся столбцами, а записи строками. Для новой электронной таблицы, созданной для Lotus Symрhony версии 1. 0 предполагается расширение WRК. XLS Эта опция используется при копировании базы данных FoxPro в новую электронную таблицу Microsoft Excel версии 2.0 . В электронной таблице поля базы данных FoxPro становятся столбцами, а записи строками. Для новой электронной таблицы, по умолчанию, берется расширение .XLS, если вы не зададите другое в опции . DELIMITED [WITН TAB | WITН < WITН BLANК] Файл типа DELIMITED представляет собой текстовый ASCII-файл, каждая запись которого заканчивается возвратом каретки и перево- дом строки. Поля обычно разделяются запятыми, а символьные поля дополнительно берутся в двойные кавычки. Например, "Smith", 9999999, "TELEPНONE" Однако, для задания файлов, которые должны содержать поля, разделяемые не запятыми, а одним пробелом или символом табуляции, можно использовать опции DELIMITED WITН BLANК или DELIMITED WITН TAB соответственно, а для указания на то, что символьные поля разделяются не двойными кавычками, а какими-либо другими символа- ми, может использоваться опция DELIMITED WITН (<раз- делитель>). Для всех файлов DELIMITED предполагается использова- ние расширения .TXT. Пример USE customer COPY NEXT 3 TO temр TYPE DELIMITED В этом примере открывается база данных CUSTOMER и следующие три записи копируются во вновь создаваемый разделенный файл дан- ных TEMP.TXT.