EDITSOURCE( ) Function
Opens the Visual FoxPro editor and, optionally positions the cursor. Required by Editor Tasklist Shortcuts.
EditSource(cShortCutID | [ cFilename [, nLineNo] [, cClassName]
[, cMethodName|cProcName]])
Parameters
- cShortCutID
Specifies the valid shortcut ID - cFileName
Specifies the name of the file to open. If the file is already open, Visual FoxPro activates it. - nLineNo
Specifies the line at which to position the cursor. If you use 0, the cursor is positioned at the last location saved in the resource file. If you provide an invalid or non-existent nlineno, the cursor is positioned at the beginning of the current file. A negative nlineno value will generate an error. - cClassName
Specifies the name of a class or data environment to be edited. If you open a class file (.vcx) without naming a class, the Class Designer opens instead of the editor. - cMethodName
Specifies the name of a method to be edited. Use a valid object-referenced method in the form cObject.nMethodName. - cProcName
Specifies the name of a procedure to be edited in a class type file (.vcx, .scx, .frx, .lbx).
Return Values
Logical. Returns true (.T.) if the target file opens successfully, otherwise returns error codes according to the following table:
| Value | Description |
|---|---|
| 0 | Successful file opening. |
| 132, 705 | File in use. Cannot be opened. |
| 200 | File not opened due to invalid object reference. Verify the presence of cMethodName in the object referenced by the cClassName parameter. |
| 901, 925 | File opened but invalid object reference in cMethodName. Check the reference in the cMethodName parameter. Use a reference such as MyForm.MyList.CLICK. Forms and classes return 925; reports return 901. |
Remarks
You can pass cShortCutID without any additional information and have the editor open at that location. The cShortCutID is the unique ID value for a shortcut record stored in the Foxtask system table (_VFP.FoxTask). The Task List application uses this table to ensure that it can get the latest line position of the shortcut. Visual FoxPro maintains, internally, current shortcut information, but only writes line position updates to Foxtask when a file is saved.
The file extension determines which Visual FoxPro editor opens, according to the following table:
| Extension | Editor | Default Settings |
|---|---|---|
| PRG | Text Editor | MODIFY COMMAND |
| MPR | Text Editor | MODIFY COMMAND |
| QPR | Text Editor | MODIFY COMMAND |
| TXT | Text Editor | MODIFY FILE |
| SCX | Code Snippet | MODIFY FORM |
| VCX | Code Snippet | MODIFY CLASS |
| FRX | Code Snippet | MODIFY REPORT |
| LBX | Code Snippet | MODIFY LABEL |
| MNX | Menu Snippet | MODIFY MENU |
| DBC | Stored Procedures | MODIFY PROCEDURE |
| <other> | Text Editor | MODIFY FILE |
Program (.prg), database (.dbc stored procedures) and text files support only the nLineNo parameter.
Menu file (.mnx) are opened as text files without reference to objects or to line numbers.