Added wxUSE_POCKETPC_UI to distinguish between using
[wxWidgets.git] / docs / msw / wince / readme.txt
1
2   =================================================
3   Welcome to wxWindows/CE 2.5.1
4   =================================================
5
6 You have downloaded version 2.5.1 of the Windows CE port of
7 the wxWindows GUI library. This runs on PocketPC 2002,
8 SmartPhone 2002, and Windows CE .NET 4.x.
9
10 More information about the wxWindows project as a whole
11 can be found at:
12
13   http://www.wxwindows.org
14
15 Information about the Windows CE port in particular
16 can be found here:
17
18 http://wiki.wxwindows.org/wiki.pl?Windows_CE_Port
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 wxWindows project files.
47
48 wxWindows/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 wxWindows/CE Compilation
77 ================================
78
79 Open src/msw/wince/wxWindowsCE.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 Status
89 ======
90
91 Currently under development. For further information
92 about what has been done and what needs to be
93 done, see:
94
95 http://wiki.wxwindows.org/wiki.pl?Developers_Notebook/WxWinCE
96
97 Disclaimer
98 ==========
99
100 All product names are used for identification purposes and are trademarks 
101 or registered trademarks owned by their respective companies.
102