Windows CE

This is just a 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

If the setup.exe program fails, extract the appropriate cab file from the ZIP archive, transfer it to the mobile device and execute it there.

The setup program performes the following:

• Files
  Unpacks and copies the program files, documents and libraries under the directory \Program Files\BRexxCE\ on the Window CE device.

• Registry
  Updates the registry with the following entries:
  • Makes the files with extension ".r" as executable

    	[HKEY_CLASSES_ROOT\.r]
    	@=brexxfile
    
    	[HKEY_CLASSES_ROOT\brexxfile]
    	@=BRexx program
    
    	[HKEY_CLASSES_ROOT\brexxfile\DefaultIcon]
    	@=\Program Files\BRexxCE\brexxce.exe,-103
    
    	[HKEY_CLASSES_ROOT\brexxfile\Shell]
    
    	[HKEY_CLASSES_ROOT\brexxfile\Shell\Open]
    
    	[HKEY_CLASSES_ROOT\brexxfile\Shell\Open\Command]
    	@="\Program Files\BRexxCE\brexxce" "%1" %*
    	

  • Library path, and other options

    	[HKEY_CURRENT_USER\Software\Marmita]
    
    	[HKEY_CURRENT_USER\Software\Marmita\BRexx]
    	LIB=\Program Files\BRexxCE\Lib
    	

    Where:

    Font	The characters font size
    Menu	Menu visibility
    Scrollbars	Scrollbars visibility
    Mark	Stylus is used for marking(selecting) or panning
    Lib	the BRexx libraries path

Running

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

Current Directory

• CHDIR
• COPYFILE
• DELFILE
• DIR
• MOVEFILE
• OPEN

Environment

Copy / Paste

Menu

CE Functions description

Console functions

Returns the index of the background color.

CHDIR([newdir])

Changes the current directory to newdir if existing and returns the current working directory before the change.

CLRSCR()

Clear the main window.

CLREOL()

Clear from cursor position until end of the line.

FGCOLOR()

Returns the index of the foreground color.

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.

SETCOLOR(FG[,BG])

Change the active color to foreground FG index and background BG. Returns the previous active color BG*16+FG. Colors are:

0	Black	8	Dark Gray
1	Dark Red	9	Red
2	Dark Green	10	Green
3	Dark Yellow	11	Yellow
4	Dark Blue	12	Blue
5	Dark Magenta	13	Magenta
6	Dark Cyan	14	Cyan
7	Gray	15	White

SETFONTSIZE(size)

Sets the font size of the screen. Valid values are from 6 to 50pt.

SCROLLBARS([0|1])

Enable or disable window scrollbars. Returns the current setting.

WHEREX(), WHEREY()

Returns the position of the cursor on screen.

File System functions

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

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.

WINDOWEXIT()

Terminates and closes the text window

WINDOWTITLE(title)

Set the window title to title.

WIN32 Related Functions

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

Returns the unicode version of the ascii-string.

Returns the ascii version of the unicode-string.