Команда MODIFY FILE

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

Синтаксис

MODIFY FILE [FileName | ?]
[NOEDIT]
[NOMENU]
[NOWAIT]
[RANGE nStartCharacter, nEndCharacter]
[[WINDOW WindowName1]
[IN [WINDOW] WindowName2 | IN SCREEN | IN MACDESKTOP]]
[AS nCodePage]
[SAME]
[SAVE]

Параметры

FileName

Задает имя для текстового файла. Если вы не задали расширение для нового текстового файла, Visual FoxPro автоматически присвоит ему расширение .TXT. Команда MODIFY FILE поддерживает шаблон имен файлов, содержащий символы подстановки звездочку (*) и вопросительный знак (?). Для каждого текстового файла, имя которого соответствует заданному шаблону, открывается свое окно редактирования.

Если имя файла опущено, открывается окно редактирования файла с начальным име ем FILE1. Закрывая окно редактирования, Вы сможете сохранить этот файл под д угим именем.

?

Отображает диалоговое окно Open, в котором можно выбрать текстовый файл.

NOEDIT

Указывает, что файл нельзя изменять, но можно просматривать и копировать в уфер обмена.

NOMENU

Допустимо в Visual FoxPro, FoxPro для Windows и FoxPro для Macintosh.

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

В FoxPro для Windows и FoxPro для Macintosh удаляет меню Text из системной ст оки меню Visual FoxPro, чтобы нельзя было изменять шрифт, размер шрифта, межст очный интервал и отступы, а также выполнять проверку орфографии.

В FoxPro для MS-DOS предложение NOMENU игнорируется.

NOWAIT

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

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

Когда вы с помощью одной команды MODIFY FILE открываете более одного окна ре актирования, опция NOWAIT срабатывает неявно. Например:

MODIFY FILE *.TXT

RANGE nStartCharacter, nEndCharacter

Задает диапазон символов, которые выделяются при открытии окна редактирования. Символы выделяются, начиная с позиции, заданной аргументом nStartCharacter, и кончая позицией, заданной аргументом nEndCharacter (исключая ее). Если значение nStartCharacter равно nEndCharacter, никакие символы не выделяются и курсор помещается в позицию, указанную а гументом nStartCharacter.

WINDOW WindowName1

Задает окно, характеристики которого перенимает окно редактирования. Например, если окно создано по команде DEFINE WINDOW с предложением FLOAT, окно редакти ования можно будет перемещать. Заданное окно не обязательно должно быть активн м или видимым, но оно должно быть определено.

IN [WINDOW] WindowName2

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

Чтобы получить доступ к окну редактирования, нужно предварительно определить его родительское окно с помощью команды DEFINE WINDOW и сделать его видимым.

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.

AS nCodePage

Автоматически преобразует символы с ударением в текстовом файле, созданном на ругой платформе Visual FoxPro. Числовое выражение nCodePage задает кодовую страницу той платформы Visual FoxPro, на которой создавался текстовый файл. Файл будет сохранен в этой же кодовой странице, если только вы не сохраните его в другой кодовой странице командой Save As из меню File.

SAME

Запрещает переводить окно редактирования на передний план в качестве активного окна. Если окно редактирования скрыто, оно отображается, но не становится активным.

SAVE

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

Комментарии

Когда в текстовый файл вносятся изменения, обновленный файл записывается на иск. В Visual FoxPro файл резервной копии с расширением имени .BAK создается, ес и вы установили флажок Make Backup Copy на вкладке Edit диалогового окна Options, которое появляется при выборе команды Options в меню Tools. В предыдущей ве сии FoxPro для этого файла будет создана резервная копия с расширением имени .BAK, если установить переключатель Backup в диалоговом окне Preferences, появ яющемся при выборе команды Preferences в меню Edit.

Для внесения изменений используется редактор Visual FoxPro, если вы не задали какой-либо внешний редактор в файле конфигурации (опция TEDIT).