docs/msw/wince/readme.txt

   1
   2   =================================================
   3   Welcome to wxWidgets/CE 2.5.2
   4   =================================================
   5
   6 You have downloaded version 2.5.2 of the Windows CE port of
   7 the wxWidgets GUI library. This runs on PocketPC 2002,
   8 SmartPhone 2002, and Windows CE .NET 4.x.
   9
  10 More information about the wxWidgets project as a whole
  11 can be found at:
  12
  13   http://www.wxwidgets.org
  14
  15 Information about the Windows CE port in particular
  16 can be found here:
  17
  18 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
  19
  20 Supported platforms
  21 ===================
  22
  23 These are the supported platforms at the moment:
  24
  25 - x86 emulator
  26 - PocketPC (StrongARM)
  27
  28 You can test the library and applications using PocketPC emulator
  29 and/or Compaq iPAQ or other PDAs using PocketPC
  30
  31 Compiler installation
  32 =====================
  33
  34 Get the Visual C++ embedded (FREE) from Microsoft website
  35  http://msdn.microsoft.com/vstudio/device/embedded/download.asp
  36
  37 You must use Embedded Visual C++ 3.0 or Embedded Visual C++ 4.x.
  38
  39 Install selecting only the two target platforms used:
  40
  41 - WCE x86em (PocketPC emulation)
  42 - WCE ARM (PocketPC StrongARM)
  43
  44 You can install other targets but you will need
  45 to create new configurations for them in the
  46 wxWidgets project files.
  47
  48 wxWidgets/CE Configuration
  49 ================================
  50
  51 You may wish to customize the following file
  52 before compiling wxWinCE:
  53
  54 include/wx/msw/wince/setup.h
  55
  56 These are some of the Windows CE-specific settings
  57 you can adjust.
  58
  59 wxUSE_POCKETPC_UI
  60
  61   If you are compiling with Windows CE .NET, you may
  62   wish to emulate PocketPC behaviour (set it to 1), or
  63   take advantage of the greater flexibility of
  64   Windows CE .NET (set it to 0).
  65   If 0, the PocketPC-specific toolbar class will be
  66   used, which uses commandbar to combine the toolbar
  67   and menubar in one control. If 1, the normal menubar
  68   and toolbar behaviour will be used, as per
  69   desktop Windows.
  70
  71 wxUSE_SMARTPHONE
  72
  73   Set this to 1 if you wish to compile for the SmartPhone
  74   platform (with eVC++ 3).
  75
  76 wxWidgets/CE Compilation
  77 ================================
  78
  79 Open src/msw/wince/wxWidgetsCE.vcp, select an
  80 ARM or x86 target (or emulator target for eVC++ 4),
  81 and compile.
  82
  83 Then open samples/minimal/minimalCE.vcp, select an
  84 ARM, x86 or emulator target, and compile. You can
  85 use the emulator or real hardware to run the
  86 sample.
  87
  88 There may be long delays while VC++ computes dependencies, and expect
  89 to wait a long time for loading and saving the workspace.
  90
  91 To compile using the emulator on eVC++3:
  92
  93 - Open src/msw/wince/wxWidgetsCE.vcp, select the
  94   WIN32 (WCE x86) Debug Unicode configuration, close the dialog,
  95   then select Pocket PC 2002 and Pocket PC 2002 Emulation on the toolbar,
  96   and compile.
  97
  98 - Open samples/minimal/minimalCE.vcp, select the
  99   WIN32 (WCE x86 Debug) configuration, select Pocket PC 2002 and
 100   Pocket PC 2002 Emulation as before, and compile.
 101
 102 To compile using the emulator on eVC++4:
 103
 104 - Open src/msw/wince/wxWidgetsCE.vcp, select the
 105   WIN32 (WCE Emulator) Debug Unicode configuration, and compile.
 106
 107 - Open samples/minimal/minimalCE.vcp with eCV 4.0, select the
 108   WIN32 (WCE emulator) Debug configuration, and compile.
 109
 110 Status
 111 ======
 112
 113 Currently under development. For further information
 114 about what has been done and what needs to be
 115 done, see:
 116
 117 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
 118
 119 Disclaimer
 120 ==========
 121
 122 All product names are used for identification purposes and are trademarks
 123 or registered trademarks owned by their respective companies.
 124