Fixed source for WinCE compatibility

[wxWidgets.git] / docs / msw / wince / readme.txt

  =================================================
  Welcome to wxWindows/CE 2.5.1
  =================================================

You have downloaded version 2.5.1 of the Windows CE port of
the wxWindows GUI library. This runs on PocketPC 2002,
SmartPhone 2002, and Windows CE .NET 4.x.

More information about the wxWindows project as a whole
can be found at:

  http://www.wxwindows.org

Information about the Windows CE port in particular
can be found here:

http://wiki.wxwindows.org/wiki.pl?Windows_CE_Port

Supported platforms
===================

These are the supported platforms at the moment:

- x86 emulator
- PocketPC (StrongARM)

You can test the library and applications using PocketPC emulator 
and/or Compaq iPAQ or other PDAs using PocketPC

Compiler installation
=====================

Get the Visual C++ embedded (FREE) from Microsoft website
 http://msdn.microsoft.com/vstudio/device/embedded/download.asp
 
You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.
 
Install selecting only the two target platforms used:

- WCE x86em (PocketPC emulation)
- WCE ARM (PocketPC StrongARM)

You can install other targets but you will need
to create new configurations for them in the
wxWindows project files.

wxWindows/CE Configuration
================================

You may wish to customize the following file
before compiling wxWinCE:

include/wx/msw/wince/setup.h

These are some of the Windows CE-specific settings
you can adjust.

wxUSE_POCKETPC_UI

  If you are compiling with Windows CE .NET, you may
  wish to emulate PocketPC behaviour (set it to 1), or
  take advantage of the greater flexibility of
  Windows CE .NET (set it to 0).
  If 0, the PocketPC-specific toolbar class will be
  used, which uses commandbar to combine the toolbar
  and menubar in one control. If 1, the normal menubar
  and toolbar behaviour will be used, as per
  desktop Windows.

wxUSE_SMARTPHONE

  Set this to 1 if you wish to compile for the SmartPhone
  platform (with eVC++ 3).

wxWindows/CE Compilation
================================

Open src/msw/wince/wxWindowsCE.vcp, select an
ARM or x86 target (or emulator target for eVC++ 4),
and compile.

Then open samples/minimal/minimalCE.vcp, select an
ARM, x86 or emulator target, and compile. You can
use the emulator or real hardware to run the
sample.

Status
======

Currently under development. For further information
about what has been done and what needs to be
done, see:

http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE

Disclaimer
==========

All product names are used for identification purposes and are trademarks 
or registered trademarks owned by their respective companies.