X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/1a4fe894fea30f773876b7a7a2e55ece5ef7ac90..52fa6f7d168cf8186fecda8c681ed4a20156cb0a:/docs/msw/wince/readme.txt diff --git a/docs/msw/wince/readme.txt b/docs/msw/wince/readme.txt index 030f8551a1..7337d78c4a 100644 --- a/docs/msw/wince/readme.txt +++ b/docs/msw/wince/readme.txt @@ -1,70 +1,120 @@ ================================================= - Welcome to wxWindows/CE 2.3.4 (is becoming 2.5.0) + Welcome to wxWidgets/CE 2.5.2 ================================================= -You have downloaded version 2.3.4 of the WinCE 3.0 port of -the wxWindows GUI library. This runs on WindowsCE 3.0. +You have downloaded version 2.5.2 of the Windows CE port of +the wxWidgets GUI library. This runs on PocketPC 2002, +SmartPhone 2002, and Windows CE .NET 4.x. -More information about the wxWindows project as a whole +More information about the wxWidgets project as a whole can be found at: - http://www.wxwindows.org + http://www.wxwidgets.org +Information about the Windows CE port in particular +can be found here: + +http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE Supported platforms =================== -These are the supported platform at the moment +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 -WindowsCE.NET is not supported. - - - Compiler installation ===================== Get the Visual C++ embedded (FREE) from Microsoft website http://msdn.microsoft.com/vstudio/device/embedded/download.asp -You must use Visual Tools 3.0 for CE 3.0  - (this is the same we are currently using for wxWinCE) +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 +wxWidgets project files. + +wxWidgets/CE Configuration +================================ +You may wish to customize the following file +before compiling wxWinCE: -General installation notes -========================== +include/wx/msw/wince/setup.h -Alter your WXWIN environment variable to point to the root directory of the -wxWindows installation. +These are some of the Windows CE-specific settings +you can adjust. -Add wxWindows include and library paths into Tools-Options-Directories +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 -wxWindows/CE Compilation + Set this to 1 if you wish to compile for the SmartPhone + platform (with eVC++ 3). + +wxWidgets/CE Compilation ================================ -The following sections explain how to compile wxWindows/CE with the -Visual C++ embedded compiler. +Open src/msw/wince/wxWidgetsCE.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. +There may be long delays while VC++ computes dependencies, and expect +to wait a long time for loading and saving the workspace. +To compile using the emulator on eVC++3: + +- Open src/msw/wince/wxWidgetsCE.vcp, select the + WIN32 (WCE x86) Debug Unicode configuration, close the dialog, + then select Pocket PC 2002 and Pocket PC 2002 Emulation on the toolbar, + and compile. + +- Open samples/minimal/minimalCE.vcp, select the + WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and + Pocket PC 2002 Emulation as before, and compile. + +To compile using the emulator on eVC++4: + +- Open src/msw/wince/wxWidgetsCE.vcp, select the + WIN32 (WCE Emulator) Debug Unicode configuration, and compile. + +- Open samples/minimal/minimalCE.vcp with eCV 4.0, select the + WIN32 (WCE emulator) Debug configuration, and compile. Status ====== -Currently develompment - +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 ========== @@ -72,9 +122,3 @@ Disclaimer All product names are used for identification purposes and are trademarks or registered trademarks owned by their respective companies. - - - Marco Cavallini -www.koansoftware.com - -.eof.