Открывает Редактор Visual FoxPro и устанавливает курсор в заданную позицию Текста.
EditSource(cShortCutID | [ cFilename [, nLineNo] [, cClassName] |
Параметры
- cShortCutID
-
Определяет существующий контекстный идентификатор ID.
- cFileName
-
Определяет имя открываемого в Редакторе программного файла. Если данный файл уже открыт, Visual FoxPro активирует окно открытого файла.
- nLineNo
-
Определяет номер строки Текста, в которую устанавливается курсор. Если задано значение = 0, курсор устанавливается в позицию, которая сохранена в Ресурсном файле для заданного объекта. Если вы определяете данный параметр как несуществующую строку Текста, курсор устанавливается в начало программного файла. Отрицательное значение параметра nlineno порождает возникновение Ошибочной ситуации.
- cClassName
-
Определяет имя Класса или Среды Данных (Data Environment), для редактирования. Если вы открываете файл библиотеки Классов (.vcx) без указания конкретного класса из этой библиотеки, вместо Редактора открывается системный Дизайнер (Class Designer).
- cMethodName
-
Определяет имя Метода, программный текст которого открывается в Редакторе. Необходимо указывать в данном параметре существующую объектную ссылку на требуемый метод, в форме: cObject.nMethodName.
- cProcName
-
Определяет имя процедуры для редактирования в соответствующем программном файле (.vcx, .scx, .frx, .lbx).
Возвращаемое значение
Логического типа (Logical). Возвращается значение = True (.T.), если указанный программный файл открыт в Редакторе, в противном случае возвращается числовое значение Ошибки, которые приведены в следующей Таблице:
Значение | Краткое Описание |
---|---|
0 | Файл успешно Открыт. |
132, 705 | Файл уже используется. Не может быть открыт вторично. |
200 | Файл не может быть открыт по причине неверно указанной объектной ссылке. Необходимо проверить значения заданных параметров cMethodName / cClassName. |
901, 925 | Открываемый файл содержит неверную ссылку на объект в параметре cMethodName. Необходимо проверить ссылку в параметре cMethodName. Форма объектной ссылки должна быть: MyForm.MyList.CLICK. Формы и Классы возвращают значение = 925; Отчеты возвращают значение = 901. |
Комментарии
Вым достаточно передать только уникальный идентификатор cShortCutID, без указания дополнительной информации, Редактор откроется в требуемой вам позиции. Данный уникальный идентификатор cShortCutID является уникальным ключем ID для сохраненных записей в системной таблице Foxtask, имя который хранится в системной переменной (_VFP.FoxTask). Список Задач (Task List) Приложения использует указанную таблицу для определения последней позиции курсора редактируемого ранее программного файла по соответствующему уникальному идентификатору ID. Visual FoxPro поддерживает сохранение текущей контекстной информации в указанной таблице Foxtask только при сохранении программного файла.
Для следующих типов (расширений) программных файлов Visual FoxPro открываются следующие системные Компоненты:
Тип (Расширение) | Редактор / Компонента | Установка по-умолчанию |
---|---|---|
PRG | Text Editor |
MODIFY COMMAND |
MPR | Text Editor | MODIFY COMMAND |
QPR |
Text Editor | MODIFY COMMAND |
TXT | Text Editor |
MODIFY FILE |
SCX | Code Editor | MODIFY FORM |
VCX | Code Editor | MODIFY CLASS |
FRX |
Code Editor | MODIFY REPORT |
LBX | Code Editor |
MODIFY LABEL |
MNX | Menu Editor | MODIFY MENU |
DBC | Stored Procedures | MODIFY PROCEDURE |
<other-другие> | Text Editor |
MODIFY FILE |
Процедурные файлы (.prg), Базы данных (.dbc хранимые процедуры), текстовые файлы поддерживают только параметр строки nLineNo.
Файлы Меню (.mnx) открываются без указания на объектные ссылки или номера строк.