finished documentation for the new build system
[wxWidgets.git] / docs / msw / winxp.txt
1 Microsoft Windows XP Support from wxWindows 2.3.2
2 -------------------------------------------------
3
4 Windows XP introduces the themes (called "visual styles" in the Microsoft
5 documentation) in Windows world. As wxWindows uses the standard Windows
6 controls for most of its classes, it can take advantage of it without
7 (almost) any effort from your part. The only thing you need to do if you
8 want your program to honour the visual style setting of Windows XP is to
9 add the manifest file to your program (this is not at all specific to
10 wxWindows programs but is required for all Windows applications).
11
12
13 For your convenience, below is an example manifest. It should be put in a
14 file called "yourapp.exe.manifest" and put in the same directory where
15 "yourapp.exe" resides. Alternatively, you can include the manifest in your
16 applications resource section. Please see the MSDN documentation at
17
18 http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnwxp/html/xptheming.asp
19
20 for more details.
21
22
23 Here is the example manifest which you can put into controls.exe.manifest
24 file to test theme support using the controls sample:
25
26 --- cut here ---
27 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
28 <assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
29 <assemblyIdentity
30     version="0.64.1.0"
31     processorArchitecture="x86"
32     name="Controls"
33     type="win32"
34 />
35 <description>Controls: wxWindows sample application</description>
36 <dependency>
37     <dependentAssembly>
38         <assemblyIdentity
39             type="win32"
40             name="Microsoft.Windows.Common-Controls"
41             version="6.0.0.0"
42             processorArchitecture="X86"
43             publicKeyToken="6595b64144ccf1df"
44             language="*"
45         />
46     </dependentAssembly>
47 </dependency>
48 </assembly>
49 --- cut here ---
50
51
52 There are a few minor problems with theme support in wxWindows currently
53 which will be fixed in the next releases:
54
55 - the buttons with non-default colours are owner-drawn and thus don't
56   follow the visual style look but always have the default 3D look of
57   the previous Windows versions - don't change the buttons colours if
58   you want them to look nicely under Windows XP
59
60 - wxCheckListBox control doesn't have the same appearance as the native
61   checkboxes in Windows XP
62