Previous Top Index Next

Windows CE

This is just a small description of the functions and installation procedure. is not intended to be a complete documentation for the Windows CE functions of BREXX.

WARNING function names might change in the next releases.

Any comments or ideas about the program and the CE version are very welcome.

Installation

In the next release the installation will be automatic :)
But for the moment what you should do is:

Running

You can either execute the brexx interpreter from
Start -> Run...
\Program Files\Rexx\brexxce.exe \Temp\MyProg.r arg1 arg2
or if you have added in the registry the ".r" as an executable extension then you can just double click from the explorer the rexx program "\Temp\MyProg.r".

If the path of your rexx program contains space characters, then you must use quotes. \...\brexxce.exe "\Program Files\Rexx\Progs\calc.r"

Environment

Rexx is a text based language, (may be in the future I can add graphics, windows and dialogs), but for the moment the interpreter runs in a text window with 100 lines of text (This will be variable in next releases). The number of columns is variable depending of the dimensions of the screen. This will be an option in the registry, as well the selected font.

Copy / Paste

You can select a text to be copied in the clipboard with the pen/mouse by dragging a rectangular area. When the pen is lifted up, then the text in the selected area is immediately copied to Clipboard. NOTE that the region it doesn't remain high-lighted

Menu

By pressing the ALT-key and tapping in the screen a small popup menu appears with several options

CE Functions description

The following functions are currently implemented in the CE version. Please note that names and functionality might change in the next releases.

Console functions

CLRSCR()
Clear the main window.

CLREOL()

Clear from cursor position until end of the line.

WHEREX(), WHEREY()

Returns the position of the cursor on screen.

GOTOXY(x,y)

Move cursor to x,y position on screen.

GETCH()

Get character, from keyboard buffer. Special characters (like arrows) are returned with two calls in the GETCH() routine. The first returns zero char '00'x and then the actual value of the key being pressed.

KBHIT()

Returns 1 if a character is waiting in the keyboard buffer, else 0.

File System functions

COPYFILE(srcfile,destfile)
Copy file srcfile to destfile.

MOVEFILE(srcfile,destfile)

Move/Rename or Replace file srcfile to destfile.

DELFILE(file)

Delete the file file.

MKDIR(directory)

Create a new directory directory.

RMDIR(directory)

Remove the directory directory.

DIR(filemask)

Return a string containing the complete directory list. This list contains the file informations: size, date, attributes. The file entries are separated with a newline "\n" ('0A'x) character.

Windows functions

WINDOWTITLE(title)
Set the window title to title.

MSGBOX(text, title, [option])

Displays a message box, containing text text and a title title. An optional integer option can be specified, to define the buttons and the icons that will be visible inside the messagebox. The options are the same as described in the Windows API, and a short list can be found in the lib/WinCE.r library file.

WIN32 Related Functions

CLIPBOARD([type|cmd [,data]])
Get, Set, List or Clear the available data in clipboard.
CLIPBOARD() returns a list of the available types in clipboard
CLIPBOARD('L') -//-
CLIPBOARD('C') clears all data in clipboard
CLIPBOARD(13) gets the type 13=UNICODE text from clipboard
CLIPBOARD(13,string) sets the type 13 with the data string.
CLIPBOARD(13,A2U("Hello"))
WARNING strings in Windows CE are UNICODED, while internaly in BRexx are ASCII. Functions A2U(), and U2A() should be used for translating.
Some commonly used clipboard data formats can be found in lib/WinCE.r library file.

Unicode Functions

A2U(ascii-string)
Returns the unicode version of the ascii-string.
U2A(unicode-string)
Returns the ascii version of the unicode-string.

Previous Top Index Next