BCX System variables
BCX recognizes the following declarations as static char system variables pre-set to the values indicated in the comments.
☞ It is the programmer's responsibility not to alter the contents of these 16 string system variables.
NUL$ ' Null ASCII character 0 BEL$ ' Bell ASCII character 7 BS$ ' Back Space ASCII character 8 TAB$ ' Horizontal Tab ASCII character 9 LF$ ' Line Feed ASCII character 10 VT$ ' Vertical Tab ASCII character 11 FF$ ' Form Feed ASCII character 12 CR$ ' Carriage Return ASCII character 13 EF$ ' End-of-File ASCII character 26 ESC$ ' Escape ASCII character 27 SPC$ ' Space ASCII character 32 DQ$ ' Quotation Mark ASCII character 34 DDQ$ ' Double-Double Quotation Mark ASCII character 34 CRLF$ ' Carriage Return and Line Feed TRUE ' has a value of 1 FALSE ' has a value of 0
BCX_CONSOLE global handle
BCX translates BCX_CONSOLE to "hConsole" which is a global handle, used for decades by most of the BCX console runtime code. BCX not only does the text translation, it also emits the relevant C \ C++ code that declares and initializes hConsole, so you don't have to.
Typically, when using a console mode function, a handle would be declared, and then retrieved and then, finally, used as in the following code.
DIM hOut AS HANDLE hOut = GetStdHandle(STD_OUTPUT_HANDLE) SetConsoleDisplayMode (hOut, CONSOLE_FULLSCREEN_MODE, NULL) DELAY(3) ' wait three seconds SetConsoleDisplayMode (hOut, CONSOLE_WINDOWED_MODE, NULL) PAUSE
Using BCX_CONSOLE, the code is simplified to the following
SetConsoleDisplayMode (BCX_CONSOLE, CONSOLE_FULLSCREEN_MODE, NULL) DELAY(3) ' wait three seconds SetConsoleDisplayMode (BCX_CONSOLE, CONSOLE_WINDOWED_MODE, NULL) PAUSE
CONWIN
BCX automatically transforms CONWIN to GetConsoleWindow() which is a WinAPI function that returns a window handle of the active console window. Now you can:
CENTER(CONWIN), HIDE(CONWIN), SHOW(CONWIN)
and more.
LReturn system variable
LReturn is used by the CMDHANDLER and MSGHANDLER macro functions.
☞ LReturn is case sensitive.