Language Supported in Run Times
The vfp8r.dll run-time library supports the entire language set of objects, commands, and functions, excluding design-time specific language.
To design the vfp8t.dll as a lightweight run-time library for in-process servers, many user-input commands and functions have been removed. All Object syntax is still available, though events from visual classes such as forms are disabled. The following language categories have been removed from vfp8t.dll:
- READ, @...Get/Says
- Menu, Popup, and Bar commands and functions
- MESSAGEBOX() and WAIT WINDOW
- User-defined Window commands and functions
Disabled Commands that Generate Run-Time Errors
The following table is a list of unsupported commands, which will generate one of these errors at run time in the vfp8t.dll library:
- Commands: Feature is not available
- Functions: Function is not implemented
- System variables: Variable is not found
The unsupported commands are:
| @...BOX | @...CLASS | @...CLEAR |
| @...EDIT | @...FILL | @...GET |
| @...MENU | @...PROMPT | @...SAY |
| @...SCROLL | @...TO | _ALIGNMENT |
| _ASSIST | _BEAUTIFY | _BOX |
| _CALCMEM | _CALCVALUE | _CONVERTER |
| _COVERAGE | _CUROBJ | _DBLCLICK |
| _DIARYDATE | _FOXDOC | _GALLERY |
| _GENMENU | _GENPD | _GENSCRN |
| _GETEXPR | _INCSEEK | _INDENT |
| _LMARGIN | _PADVANCE | _PBPAGE |
| _PCOLNO | _PCOPIES | _PDRIVER |
| _PDSETUP | _PECODE | _PEJECT |
| _PEPAGE | _PLENGTH | _PLINENO |
| _PLOFFSET | _PPITCH | _PQUALITY |
| _PSCODE | _PSPACING | _PWAIT |
| _RMARGIN | _SCCTEXT | _SPELLCHK |
| _STARTUP | _TABS | _THROTTLE |
| _TRANSPORT | _WRAP | |
| ACCEPT | ACTIVATE MENU | ACTIVATE POPUP |
| ACTIVATE SCREEN | ACTIVATE WINDOW | AGETCLASS() |
| AMOUSEOBJ() | ANSITOOEM() | APROCINFO() |
| ASELOBJ() | ASSERT | ASSIST |
| BAR() | BARCOUNT() | BARPROMPT() |
| BROWSE | CALL | CHANGE |
| CLEAR DEBUG | CLEAR GETS | CLEAR MACROS |
| CLEAR MENUS | CLEAR POPUPS | CLEAR PROMPT |
| CLEAR READ | CLOSE DEBUGGER | CLOSE FORMAT |
| CLOSE MEMO | CNTBAR() | CNTPAD() |
| COL() | CREATE | CREATE CLASS |
| CREATE CLASSLIB | CREATE COLOR SET | CREATE FORM |
| CREATE LABEL | CREATE MENU | CREATE PROJECT |
| CREATE QUERY | CREATE REPORT | CREATE SCREEN |
| DEACTIVATE MENU | DEACTIVATE POPUP | DEACTIVATE WINDOW |
| DEBUG | DEBUGOUT | DEFINE BAR |
| DEFINE BOX | DEFINE MENU | DEFINE PAD |
| DEFINE POPUP | DEFINE WINDOW | EDIT |
| FKLABEL() | FKMAX() | GETBAR() |
| GETCOLOR() | GETCP() | GETDIR() |
| GETEXPR() | GETFILE() | GETFONT() |
| GETPAD() | GETPICT() | GETPRINTER() |
| HELP | HIDE MENU | HIDE POPUP |
| HIDE WINDOW | IMESTATUS() | INPUT |
| KEYBOARD | LOAD | LOCFILE() |
| MCOL() | MDOWN() | MENU |
| MENU TO | MENU() | MESSAGEBOX() |
| MODIFY Commands | MOUSE | MOVE POPUP |
| MOVE WINDOW | MRKBAR() | MRKPAD() |
| MROW() | MWINDOW() | OBJNUM() |
| OBJVAR() | OEMTOANSI() | ON BAR() |
| ON ESCAPE | ON EXIT Commands | ON KEY |
| ON KEY LABEL | ON PAD | ON PAGE |
| ON READERROR | ON SELECTION BAR | ON SELECTION MENU |
| ON SELECTION PAD | ON SELECTION POPUP | PAD() |
| PLAY MACRO | POP KEY | POP MENU |
| POP POPUP | POPUP() | PRMBAR() |
| PRMPAD() | PROMPT() | PUSH KEY |
| PUSH MENU | PUSH POPUP | PUTFILE() |
| RDLEVEL() | READ | READ MENU |
| READKEY() | RELEASE BAR | RELEASE MENUS |
| RELEASE PAD | RELEASE POPUPS | RELEASE WINDOWS |
| RESTORE MACROS | RESTORE SCREEN | RESTORE WINDOW |
| ROW() | SAVE MACROS | SAVE SCREEN |
| SAVE WINDOWS | SCROLL | SHOW GET(S) |
| SHOW MENU | SHOW OBJECT | SHOW POPUP |
| SHOW WINDOW | SIZE POPUP | SIZE WINDOW |
| SKPBAR() | SKPPAD() | SUSPEND |
| VARREAD() | WAIT | WBORDER() |
| WCHILD() | WCOLS() | WEXIST() |
| WFONT() | WLAST() | WLCOL() |
| WLROW() | WMAXIMUM() | WONTOP() |
| WOUTPUT() | WMINIMUM() | WPARENT() |
| WREAD() | WROWS() | WTITLE() |
| WVISIBLE() | ZOOM WINDOW |
Disabled Commands that Generate No Run-Time Errors
The following table is a list of unsupported commands, which will not generate an error when executed at run time in vfp8t.dll library. These functions are still disabled for use in the run time; however, because of the frequency of usage in commonly used code and class libraries between different types of applications, they do not cause an error. When one of these commands or functions is encountered in code, Visual FoxPro ignores that line of code and continues executing. This includes certain SET commands and SYS functions.
| CD | CHDIR | DOEVENTS |
| SET ASSERTS | SET BELL | SET BORDER |
| SET BROWSEME | SET BRSTATUS | SET CONSOLE |
| SET COLOR | SET CLEAR | SET CLOCK |
| SET COVERAGE | SET CONFIRM | SET CURSOR |
| SET CPDIALOG | SET DEBUGOUT | SET DEBUG |
| SET DEFAULT | SET DEVELOPMENT | SET DELIMITERS |
| SET DISPLAY | SET DOHISTORY | SET ESCAPE |
| SET ECHO | SET EVENTLIST | SET EVENTTRACKING |
| SET FORMAT | SET FUNCTION | SET HELP |
| SET INTENSITY | SET MARK OF | SET MACDESKTOP |
| SET MACKEY | SET MARGIN | SET MESSAGE |
| SET NOTIFY | SET ODOMETER | SET PALETTE |
| SET PDSETUP | SET READBORDER | SET REFRESH |
| SET RESOURCE | SET SAFETY | SET SKIP OF |
| SET STICKY | SET STATUS | SET SYSMENU |
| SET TALK | SET TRBETWEEN | SET TYPEAHEAD |
| SET VIEW | SET WINDOW | SYS(1037) |
| SYS(18) | SYS(103) | SYS(2002) |
| SYS(1270) | SYS(2017) | SYS(4204) |
| SYS(2016) |
The following table lists the properties and functions added to Visual FoxPro to make it easier to manage Automation clients and servers. See each topic for further information.
| New Server language elements | Description |
| COMARRAY( ) Function | Specifies how arrays are passed to COM objects. |
| COMCLASSINFO( ) Function | Returns registry information about a COM object such as a Visual FoxPro Automation server. |
| COMRETURNERROR( ) Function | Populates the COM exception structure with information that Automation clients can use to determine the source of Automation server errors. |
| CREATEOBJECTEX( ) Function | Creates an instance of a registered COM object (such as a Visual FoxPro Automation server) on a remote computer. For a Visual FoxPro in-process .dll, you can use Microsoft Transaction Server to create an instance of the .dll on a remote computer. |
| EVENTHANDLER( ) Function | Binds a COM server event to implemented interface methods in an instantiated Visual FoxPro object. |
| ProcessID Property | Returns the ID of the Process that created the object. |
| ServerName Property | Contains the full path and file name for an Automation server. The ServerName property is a property of the Application object. |
| StartMode Property | Contains a numeric value that indicates how the instance of Visual FoxPro was started. |
| SYS(2334) – Automation Server Invocation Mode | Returns a value that indicates how a Visual FoxPro automation server method was invoked. |
| SYS(2335) – Unattended Server Mode | Enables or disables support for modal states in distributable Visual FoxPro .exe Automation servers. |
| SYS(2336) - Critical Section Support Function | Controls access of critical section in Multithreaded servers. |
| SYS(2339) - Internal Global Variable Function | Returns current value of internal global variable called g_fCallCoFreeOnRelease. |
| ThreadID Property | Returns the ID of the thread on which the object was created. |
See Also
Selection of a Run-Time Library | Automation Server Programming Notes | Interoperability and the Internet | Control of Call Blocking | Selection of Process Types