]>
Commit | Line | Data |
---|---|---|
966a4a52 | 1 | |
ce3ed50d JS |
2 | <HTML> |
3 | ||
4 | <HEAD> | |
c140b7e7 | 5 | <TITLE>wxWidgets 2 for Windows FAQ</TITLE> |
ce3ed50d JS |
6 | </HEAD> |
7 | ||
4e4dc03d | 8 | <BODY BGCOLOR=#FFFFFF TEXT=#000000 VLINK="#00376A" LINK="#00529C" ALINK="#313063"> |
ce3ed50d JS |
9 | |
10 | <font face="Arial, Lucida Sans, Helvetica"> | |
11 | ||
4e4dc03d | 12 | <table width=100% border=0 cellpadding=3 cellspacing=0> |
ce3ed50d | 13 | <tr> |
4e4dc03d JS |
14 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> |
15 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
c140b7e7 | 16 | <b>wxWidgets 2 for Windows FAQ</b> |
ce3ed50d JS |
17 | </font> |
18 | </td> | |
19 | </tr> | |
20 | </table> | |
21 | ||
22 | <P> | |
23 | ||
24 | See also <a href="faq.htm">top-level FAQ page</a>. | |
25 | <hr> | |
8b283bb8 JS |
26 | <h3>List of questions in this category</h3> |
27 | <ul> | |
28 | <li><a href="#platforms">Which Windows platforms are supported?</a></li> | |
29 | <li><a href="#wince">What about Windows CE?</a></li> | |
4e4dc03d | 30 | <li><a href="#winxp">What do I need to do for Windows XP?</a></li> |
8b283bb8 | 31 | <li><a href="#compilers">What compilers are supported?</a></li> |
c140b7e7 | 32 | <li><a href="#bestcompiler">Which is the best compiler to use with wxWidgets 2?</a></li> |
8b283bb8 | 33 | <li><a href="#unicode">Is Unicode supported?</a></li> |
c140b7e7 JS |
34 | <li><a href="#doublebyte">Does wxWidgets support double byte fonts (Chinese/Japanese/Korean etc.)?</a></li> |
35 | <li><a href="#dll">Can you compile wxWidgets 2 as a DLL?</a></li> | |
8b283bb8 | 36 | <li><a href="#exesize">How can I reduce executable size?</a></li> |
c140b7e7 | 37 | <li><a href="#mfc">Is wxWidgets compatible with MFC?</a></li> |
eb269381 | 38 | <li><a href="#setuph">Why do I get errors about setup.h not being found?</a></li> |
4f3b37fd | 39 | <li><a href="#asuffix">Why do I get errors about FooBarA when I only use FooBar in my program?</a></li> |
8b283bb8 | 40 | <li><a href="#newerrors">Why my code fails to compile with strange errors about new operator?</a></li> |
c140b7e7 | 41 | <li><a href="#mfcport">How do I port MFC applications to wxWidgets?</a></li> |
8b283bb8 | 42 | <li><a href="#crash">Why do I sometimes get bizarre crash problems using VC++ 5/6?</a></li> |
c140b7e7 JS |
43 | <li><a href="#makefiles">How are the wxWidgets makefiles edited under Windows?</a></li> |
44 | <li><a href="#vcdebug">How do you use VC++'s memory leak checking instead of that in wxWidgets?</a></li> | |
8b283bb8 | 45 | <li><a href="#shortcutproblem">Why are menu hotkeys or shortcuts not working in my application?</a></li> |
4e4dc03d | 46 | <li><a href="#regconfig">Why can I not write to the HKLM part of the registry with wxRegConfig?</a></li> |
c2d48b36 | 47 | <li><a href="#access">Is MS Active Accessibility supported?</a></li> |
162a956b | 48 | <li><a href="#dspfmt">Why does Visual C++ complain about corrupted project files{/a></li> |
6f92b0bb | 49 | <li><a href="#crtmismatch">Visual C++ gives errors about multiply defined symbols, what can I do?</a></li> |
15a2de7e | 50 | <li><a href="#directx">Why do I get compilation erros when using wxWidgets with DirectShow?</a></li> |
09e7b3a0 | 51 | <li><a href="#handlewm">How do I handle Windows messages in my wxWidgets program?</a></li> |
8b283bb8 JS |
52 | </ul> |
53 | <hr> | |
ce3ed50d | 54 | |
8b283bb8 | 55 | <h3><a name="platforms">Which Windows platforms are supported?</a></h3> |
ce3ed50d | 56 | |
c140b7e7 | 57 | wxWidgets 2 can be used to develop and deliver applications on Windows 3.1, Win32s, |
4e4dc03d JS |
58 | Windows 95, Windows 98, Windows NT, Windows 2000, and Windows XP. A Windows CE |
59 | version is being looked into (see below).<P> | |
b953bdc2 | 60 | |
c140b7e7 | 61 | wxWidgets 2 is designed to make use of WIN32 features and controls. However, unlike Microsoft, |
b953bdc2 | 62 | we have not forgotten users of 16-bit Windows. Most features |
ce3ed50d | 63 | work under Windows 3.1, including wxTreeCtrl and wxListCtrl using the generic implementation. |
8b283bb8 JS |
64 | However, don't expect very Windows-95-specific classes to work, such as wxTaskBarIcon. The wxRegConfig |
65 | class doesn't work either because the Windows 3.1 registry is very simplistic. Check out the 16-bit | |
ce3ed50d JS |
66 | makefiles to see what other files have been left out. |
67 | <P> | |
68 | 16-bit compilation is supported under Visual C++ 1.5, and Borland BC++ 4 to 5. | |
69 | <P> | |
70 | ||
c140b7e7 | 71 | wxWidgets 2 for Windows will also compile on Unix with gcc using Wine from <a href="http://www.winehq.org" target=_top>WineHQ</a>. |
b39dbf34 | 72 | The resulting executables are Unix binaries that work with the Wine Windows API emulator.<P> |
b953bdc2 | 73 | |
c140b7e7 | 74 | You can also compile wxWidgets 2 for Windows on Unix with Cygwin or Mingw32, resulting |
b953bdc2 | 75 | in executables that will run on Windows. So in theory you could write your applications |
c140b7e7 | 76 | using wxGTK or wxMotif, then check/debug your wxWidgets for Windows |
b39dbf34 | 77 | programs with Wine, and finally produce an ix86 Windows executable using Cygwin/Mingw32, |
b953bdc2 JS |
78 | without ever needing a copy of Microsoft Windows. See the Technical Note on the Web site detailing cross-compilation.<P> |
79 | ||
8b283bb8 | 80 | <h3><a name="wince">What about Windows CE?</a></h3> |
b953bdc2 | 81 | |
6f92b0bb | 82 | This port is largely complete. For further information, see the <a href="http://www.wxwidgets.org/embedded.htm#wxwince">wxEmbedded</a> page.<P> |
b953bdc2 | 83 | |
4e4dc03d JS |
84 | <h3><a name="winxp">What do I need to do for Windows XP?</a></h3> |
85 | ||
86 | In the same directory as you have your executable (e.g. foo.exe) you | |
87 | put a file called foo.exe.manifest in which you have something like | |
88 | the following: | |
89 | ||
90 | <pre> | |
91 | <?xml version="1.0" encoding="UTF-8" standalone="yes"?> | |
92 | <assembly | |
93 | xmlns="urn:schemas-microsoft-com:asm.v1" | |
94 | manifestVersion="1.0"> | |
95 | <assemblyIdentity | |
96 | processorArchitecture="x86" | |
97 | version="5.1.0.0" | |
98 | type="win32" | |
99 | name="foo.exe"/> | |
100 | <description>Foo program</description> | |
101 | <dependency> | |
102 | <dependentAssembly> | |
103 | <assemblyIdentity | |
104 | type="win32" | |
105 | name="Microsoft.Windows.Common-Controls" | |
106 | version="6.0.0.0" | |
107 | publicKeyToken="6595b64144ccf1df" | |
108 | language="*" | |
109 | processorArchitecture="x86"/> | |
110 | </dependentAssembly> | |
111 | </dependency> | |
112 | </assembly> | |
113 | </pre> | |
114 | ||
c2d48b36 JS |
115 | If you want to add it to your application permanently, |
116 | you can also include it in your .rc file using this | |
117 | line:<P> | |
118 | ||
119 | <PRE> | |
120 | 1 24 "winxp.manifest" | |
121 | </PRE> | |
122 | ||
c140b7e7 | 123 | In wxWidgets 2.5, this will be in the wx/msw/wx.rc and |
c2d48b36 JS |
124 | so will happen automatically so long as you include wx.rc |
125 | in your own .rc file.<P> | |
126 | ||
127 | For an explanation of this syntax, please see | |
128 | <a href="http://delphi.about.com/library/bluc/text/uc111601a.htm" target=_new>this | |
129 | article</a>. | |
130 | <P> | |
131 | ||
8b283bb8 | 132 | <h3><a name="compilers">What compilers are supported?</a></h3> |
ce3ed50d | 133 | |
c140b7e7 | 134 | Please see the wxWidgets 2 for Windows install.txt file for up-to-date information, but |
ce3ed50d JS |
135 | currently the following are known to work:<P> |
136 | ||
137 | <ul> | |
d61c1a6f JS |
138 | <li>Visual C++ 1.5, 4.0, 5.0, 6.0, 7.0, 7.1 |
139 | <li>Borland C++ 4.5, 5.0, 5.5 | |
140 | <li>Borland C++Builder 1.0, 3.0, X | |
141 | <li>Watcom C++ 10.6 (Win32), OpenWatcom 1.0 | |
142 | <li>Cygwin (using configure) | |
ce3ed50d | 143 | <li>Mingw32 |
d61c1a6f JS |
144 | <li>MetroWerks CodeWarrior (many versions) |
145 | <li>Digital Mars 8.34+ | |
ce3ed50d JS |
146 | </ul> |
147 | <P> | |
148 | ||
ce3ed50d | 149 | |
c140b7e7 | 150 | <h3><a name="bestcompiler">Which is the best compiler to use with wxWidgets 2?</a></h3> |
ce3ed50d | 151 | |
8b283bb8 JS |
152 | It's partly a matter of taste, but I (JACS) prefer Visual C++ since the debugger is very |
153 | good, it's very stable, the documentation is extensive, and it generates small executables. | |
154 | Since project files are plain text, it's easy for me to generate appropriate project files | |
c140b7e7 | 155 | for wxWidgets samples.<P> |
ce3ed50d | 156 | |
8b283bb8 JS |
157 | Borland C++ is fine - and very fast - but it's hard (impossible?) to use the debugger without using project files, and |
158 | the debugger is nowhere near up to VC++'s quality. The IDE isn't great.<P> | |
ce3ed50d | 159 | |
c140b7e7 JS |
160 | C++Builder's power isn't really used with wxWidgets since it needs integration with its |
161 | own class library (VCL). For wxWidgets, I've only used it with makefiles, in which case | |
8b283bb8 | 162 | it's almost identical to BC++ 5.0 (the same makefiles can be used).<P> |
ce3ed50d | 163 | |
8b283bb8 | 164 | You can't beat Cygwin's price (free), and you can debug adequately using gdb. However, it's |
ce3ed50d JS |
165 | quite slow to compile since it does not use precompiled headers.<P> |
166 | ||
167 | CodeWarrior is cross-platform - you can debug and generate Windows executables from a Mac, but not | |
168 | the other way around I think - but the IDE is, to my mind, a bit primitive.<P> | |
169 | ||
8b283bb8 | 170 | Watcom C++ is a little slow and the debugger is not really up to today's standards.<P> |
ce3ed50d | 171 | |
8b283bb8 JS |
172 | Among the free compilers the best choice seem to be Borland C++ command line |
173 | tools and mingw32 (port of gcc to Win32). Both of them are supported by | |
c140b7e7 | 174 | wxWidgets. |
ce3ed50d | 175 | |
8b283bb8 | 176 | <h3><a name="unicode">Is Unicode supported?</a></h3> |
ce3ed50d | 177 | |
d61c1a6f JS |
178 | Yes, Unicode is fully supported under Windows NT/2000 and there is limited |
179 | support for it under Windows 9x using <a | |
180 | href="http://www.microsoft.com/globaldev/handson/dev/mslu_announce.mspx">MSLU</a>. | |
181 | <p> | |
ce3ed50d | 182 | |
c140b7e7 | 183 | <h3><a name="doublebyte">Does wxWidgets support double byte fonts (Chinese/Japanese/Korean etc.)?</a></h3> |
4e4dc03d | 184 | |
c140b7e7 | 185 | For Japanese under Win2000, it seems that wxWidgets has no problems to work |
d61c1a6f JS |
186 | with double byte char sets (meaning DBCS, not Unicode). First you have to |
187 | install Japanese support on your Win2K system and choose for ANSI translation | |
188 | <tt>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Nls\CodePage=932</tt> | |
189 | (default is 1252 for Western). Then you can see all the Japanese letters in | |
c140b7e7 | 190 | wxWidgets applications. |
d61c1a6f | 191 | <p> |
4e4dc03d | 192 | |
c140b7e7 | 193 | <h3><a name="dll">Can you compile wxWidgets 2 as a DLL?</a></h3> |
ce3ed50d | 194 | |
9838df2c | 195 | Yes (using the Visual C++ or Borland C++ makefile), but be aware that distributing DLLs is a thorny issue |
8b283bb8 | 196 | and you may be better off compiling statically-linked applications, unless you're |
c140b7e7 | 197 | delivering a suite of separate programs, or you're compiling a lot of wxWidgets applications |
b953bdc2 JS |
198 | and have limited hard disk space.<P> |
199 | ||
c140b7e7 | 200 | With a DLL approach, and with different versions and configurations of wxWidgets |
b953bdc2 JS |
201 | needing to be catered for, the end user may end up with a host of large DLLs in his or her Windows system directory, |
202 | negating the point of using DLLs. Of course, this is not a problem just associated with | |
c140b7e7 | 203 | wxWidgets! |
b953bdc2 JS |
204 | <P> |
205 | ||
8b283bb8 | 206 | <h3><a name="exesize">How can I reduce executable size?</a></h3> |
9838df2c | 207 | |
c140b7e7 | 208 | You can compile wxWidgets as a DLL (see above, VC++/BC++ only at present). You should also |
0bc9b25e JS |
209 | compile your programs for release using non-debugging and space-optimisation options, but |
210 | take with VC++ 5/6 space optimisation: it can sometimes cause problems.<P> | |
9838df2c | 211 | |
9838df2c | 212 | If you want to distribute really small executables, you can |
4e4dc03d | 213 | use <a href="http://www.un4seen.com/petite/" target=_top>Petite</a> |
9838df2c JS |
214 | by Ian Luck. This nifty utility compresses Windows executables by around 50%, so your 500KB executable |
215 | will shrink to a mere 250KB. With this sort of size, there is reduced incentive to | |
c2d48b36 | 216 | use DLLs. Another good compression tool (probably better than Petite) is <a href="http://upx.sourceforge.net/" target=_top>UPX</a>. |
4e4dc03d | 217 | <P> |
9838df2c | 218 | |
2b5f62a0 VZ |
219 | Please do not be surprised if MinGW produces a statically-linked minimal executable of 1 MB. Firstly, gcc |
220 | produces larger executables than some compilers. Secondly, this figure will | |
c140b7e7 | 221 | include most of the overhead of wxWidgets, so as your application becomes more |
c2d48b36 | 222 | complex, the overhead becomes proportionally less significant. And thirdly, trading executable compactness |
c140b7e7 | 223 | for the enormous increase in productivity you get with wxWidgets is almost always well worth it.<P> |
c2d48b36 JS |
224 | |
225 | If you have a really large executable compiled with MinGW (for example 20MB) then | |
c140b7e7 | 226 | you need to configure wxWidgets to compile without debugging information: see |
c2d48b36 JS |
227 | docs/msw/install.txt for details. You may find that using configure instead |
228 | of makefile.g95 is easier, particularly since you can maintain debug and | |
229 | release versions of the library simultaneously, in different directories. | |
09e7b3a0 | 230 | Also, run 'strip' after linking to remove all traces of debug info. |
c2d48b36 | 231 | <P> |
2b5f62a0 | 232 | |
c140b7e7 | 233 | <H3><a name="mfc">Is wxWidgets compatible with MFC?</a></H3> |
b953bdc2 | 234 | |
c140b7e7 JS |
235 | There is a sample which demonstrates MFC and wxWidgets code co-existing in the same |
236 | application. However, don't expect to be able to enable wxWidgets windows with OLE-2 | |
b953bdc2 | 237 | functionality using MFC.<P> |
ce3ed50d | 238 | |
eb269381 JS |
239 | <H3><a name="setuph">Why do I get errors about setup.h not being found?</a></H3> |
240 | ||
c140b7e7 | 241 | When you build the wxWidgets library, setup.h is copied |
eb269381 | 242 | from include/wx/msw/setup.h to e.g. lib/mswd/wx/setup.h (the path |
d61c1a6f | 243 | depends on the configuration you're building). So you need to add |
eb269381 JS |
244 | this include path if building using the static Debug library:<P> |
245 | ||
246 | lib/mswd<P> | |
247 | ||
248 | or if building the static Release library, lib/msw.<P> | |
249 | ||
6f92b0bb | 250 | See also the <a href="http://wiki.wxwidgets.org/wiki.pl?Table_Of_Contents">wxWiki Contents</a> |
eb269381 JS |
251 | for more information.<P> |
252 | ||
253 | ||
4f3b37fd JS |
254 | <H3><a name="asuffix">Why do I get errors about FooBarA when I only use FooBar in my program?</H3> |
255 | ||
256 | If you get errors like | |
257 | <p> | |
258 | <center> | |
259 | <tt>no matching function for call to 'wxDC::DrawTextA(const char[5], int, | |
260 | int)'</tt> | |
261 | </center> | |
262 | <p> | |
263 | or similar ones for the other functions, i.e. the compiler error messages | |
264 | mention the function with the <tt>'A'</tt> suffix while you didn't | |
265 | use it in your code, the explanation is that you had included | |
266 | <tt><windows.h></tt> header which redefines many symbols to have such | |
267 | suffix (or <tt>'W'</tt> in the Unicode builds). | |
268 | ||
269 | <p> | |
270 | The fix is to either not include <tt><windows.h></tt> at all or include | |
271 | <tt>"wx/msw/winundef.h"</tt> immediately after it. | |
272 | ||
8b283bb8 JS |
273 | <H3><a name="newerrors">Why my code fails to compile with strange errors about new operator?</a></H3> |
274 | ||
275 | The most common cause of this problem is the memory debugging settings in | |
276 | <tt>wx/msw/setup.h</tt>. You have several choices: | |
277 | ||
278 | <ul> | |
279 | <li> Either disable overloading the global operator new completely by | |
280 | setting <tt>wxUSE_GLOBAL_MEMORY_OPERATORS</tt> and | |
281 | <tt>wxUSE_DEBUG_NEW_ALWAYS</tt> to 0 in this file | |
282 | <li> Or leave them on but do <tt>#undef new</tt> after including any | |
c140b7e7 JS |
283 | wxWidgets headers, like this the memory debugging will be still on |
284 | for wxWidgets sources but off for your own code | |
8b283bb8 JS |
285 | </ul> |
286 | ||
287 | Notice that IMHO the first solution is preferable for VC++ users who can use | |
288 | the <a href="#vcdebug">VC++ CRT memory debugging features</a> instead. | |
289 | ||
c140b7e7 | 290 | <H3><a name="mfcport">How do I port MFC applications to wxWidgets?</a></H3> |
8b283bb8 | 291 | |
c140b7e7 | 292 | Set up your interface from scratch using wxWidgets (especially <a href="http://www.robeling.de" target=_top>wxDesigner</a> |
eb269381 | 293 | or <a href="http://www.anthemion.co.uk/dialogblocks/" target=_new>DialogBlocks</a> -- |
8b283bb8 JS |
294 | it'll save you a <i>lot</i> of time) and when you have a shell prepared, you can start |
295 | 'pouring in' code from the MFC app, with appropriate | |
296 | modifications. This is the approach I have used, and I found | |
297 | it very satisfactory. A two-step process then - reproduce the bare | |
298 | interface first, then wire it up afterwards. That way you deal | |
299 | with each area of complexity separately. Don't try to think MFC | |
c140b7e7 | 300 | and wxWidgets simultaneously from the beginning - it is easier to |
8b283bb8 JS |
301 | reproduce the initial UI by looking at the behaviour of the MFC |
302 | app, not its code. | |
303 | ||
304 | <H3><a name="crash">Why do I sometimes get bizarre crash problems using VC++ 5/6?</a></H3> | |
ad813b00 JS |
305 | |
306 | Some crash problems can be due to inconsistent compiler | |
c140b7e7 | 307 | options (and of course this isn't limited to wxWidgets). |
ad813b00 JS |
308 | If strange/weird/impossible things start to happen please |
309 | check (dumping IDE project file as makefile and doing text comparison | |
310 | if necessary) that the project settings, especially the list of defined | |
311 | symbols, struct packing, etc. are exactly the same for all items in | |
312 | the project. After this, delete everything (including PCH) and recompile.<P> | |
313 | ||
8b283bb8 | 314 | VC++ 5's optimization code seems to be broken and can |
ad813b00 JS |
315 | cause problems: this can be seen when deleting an object Dialog |
316 | Editor, in Release mode with optimizations on. If in doubt, | |
317 | switch off optimisations, although this will result in much | |
318 | larger executables. It seems possible that the library can be created with | |
319 | strong optimization, so long as the application is not strongly | |
c140b7e7 | 320 | optimized. For example, in wxWidgets project, set to 'Minimum |
8b283bb8 JS |
321 | Size'. In Dialog Editor project, set to 'Customize: Favor Small |
322 | Code' (and no others). This will then work.<P> | |
ad813b00 | 323 | |
c140b7e7 | 324 | <H3><a name="makefiles">How are the wxWidgets makefiles edited under Windows?</a></H3> |
91c93c99 | 325 | |
966a4a52 JS |
326 | wxWidgets 2.5.x and above uses Bakefile to generate makefiles, which |
327 | is described in technical note 16 under docs/tech in your distribution. | |
328 | For 2.4.x, the following explanation applies.<P> | |
329 | ||
c140b7e7 | 330 | As of wxWidgets 2.1, there is a new system written by Vadim Zeitlin, that |
91c93c99 JS |
331 | generates the makefiles from templates using tmake.<P> |
332 | ||
8b283bb8 | 333 | Here are Vadim's notes:<P> |
91c93c99 JS |
334 | |
335 | <blockquote> | |
8b283bb8 | 336 | To use these new makefiles, you don't need anything (but see below). |
91c93c99 JS |
337 | However, you should NOT modify them because these files will be |
338 | rewritten when I regenerate them using tmake the next time. So, if | |
339 | you find a problem with any of these makefiles (say, makefile.b32) | |
8b283bb8 | 340 | you'll need to modify the corresponding template (b32.t in this |
91c93c99 JS |
341 | example) and regenerate the makefile using tmake.<P> |
342 | ||
343 | tmake can be found at | |
344 | <a href="http://www.troll.no/freebies/tmake.html" target=_new>www.troll.no/freebies/tmake.html</a>. | |
09e7b3a0 | 345 | It's a Perl5 program and so it needs Perl (doh). There is a binary for |
8b283bb8 JS |
346 | Windows (available from the same page), but I haven't used it, so |
347 | I don't know if it works as flawlessly as "perl tmake" does (note | |
348 | for people knowing Perl: don't try to run tmake with -w, it won't | |
91c93c99 JS |
349 | do you any good). Using it extremely simple: to regenerate makefile.b32 |
350 | just go to distrib/msw/tmake and type<P> | |
351 | ||
352 | <pre>tmake -t b32 wxwin.pro -o ../../src/msw/makefile.b32</pre><P> | |
353 | ||
09e7b3a0 | 354 | The makefiles are untested - I don't have any of Borland, Watcom or |
8b283bb8 | 355 | Symantec and I don't have enough diskspace to recompile even with |
91c93c99 JS |
356 | VC6 using makefiles. The new makefiles are as close as possible to the |
357 | old ones, but not closer: in fact, there has been many strange things | |
358 | (should I say bugs?) in some of makefiles, some files were not compiled | |
359 | without any reason etc. Please test them and notify me about any problems. | |
360 | Better yet, modify the template files to generate the correct makefiles | |
361 | and check them in.<P> | |
362 | ||
363 | The templates are described in tmake ref manual (1-2 pages of text) | |
364 | and are quite simple. They do contain some Perl code, but my Perl is | |
365 | primitive (very C like) so it should be possible for anybody to make | |
366 | trivial modifications to it (I hope that only trivial modifications | |
15a2de7e | 367 | will be needed). I've tagged the ol makefiles as MAKEFILES_WITHOUT_TMAKE |
91c93c99 JS |
368 | in the cvs, so you can always retrieve them and compare the new ones, |
369 | this will make it easier to solve the problems you might have.<P> | |
370 | ||
371 | Another important file is filelist.txt: it contains the list of all | |
372 | files to be compiled. Some of them are only compiled in 16/32 bit mode. | |
8b283bb8 | 373 | Some other are only compiled with some compilers (others can't compile |
91c93c99 JS |
374 | them) - all this info is contained in this file.<P> |
375 | ||
c140b7e7 | 376 | So now adding a new file to wxWidgets is as easy as modifying filelist.txt |
91c93c99 JS |
377 | (and Makefile.ams for Unix ports) and regenerating the makefiles - no |
378 | need to modify all files manually any more.<P> | |
379 | ||
380 | Finally, there is also a file vc6.t which I use myself: this one | |
8b283bb8 JS |
381 | generates a project file for VC++ 6.0 (I didn't create vc5.t because |
382 | I don't need it and can't test it, but it should be trivial to create | |
91c93c99 | 383 | one from vc6.t - probably the only things to change would be the |
8b283bb8 | 384 | version number in the very beginning and the /Z option - VC5 doesn't |
91c93c99 | 385 | support edit-and=continue). This is not an officially supported way |
c140b7e7 | 386 | of building wxWidgets (that is, nobody guarantees that it will work), |
91c93c99 | 387 | but it has been very useful to me and I hope it will be also for |
c140b7e7 | 388 | others. To generate wxWidgets.dsp run<P> |
91c93c99 | 389 | |
c140b7e7 | 390 | <pre>tmake -t vc6 wxwin.pro -o ../../wxWidgets.dsp</pre><P> |
91c93c99 JS |
391 | |
392 | Then just include this project in any workspace or open it from VC IDE | |
393 | and it will create a new workspace for you.<P> | |
394 | ||
8b283bb8 | 395 | If all goes well, I'm planning to create a template file for Makefile.ams |
91c93c99 JS |
396 | under src/gtk and src/motif and also replace all makefiles in the samples |
397 | subdirectories with the project files from which all the others will be | |
398 | generated. At least it will divide the number of files in samples | |
399 | directory by 10 (and the number of files to be maintained too). | |
400 | </blockquote> | |
ce3ed50d | 401 | |
f6081a04 JS |
402 | <P> |
403 | ||
c140b7e7 | 404 | <H3><a name="vcdebug">How do you use VC++'s memory leak checking instead of that in wxWidgets?</a></H3> |
f6081a04 JS |
405 | |
406 | Vadim Zeitlin: | |
407 | ||
408 | <pre> | |
8b283bb8 | 409 | On the VC++ level, it's just the matter of calling _CrtSetDbgFlag() in the very |
c140b7e7 | 410 | beginning of the program. In wxWidgets, this is done automatically when |
f6081a04 JS |
411 | compiling with VC++ in debug mode unless wxUSE_GLOBAL_MEMORY_OPERATORS or |
412 | __NO_VC_CRTDBG__ are defined - this check is done in wx/msw/msvcrt.h which | |
413 | is included from app.cpp which then calls wxCrtSetDbgFlag() without any | |
8b283bb8 | 414 | ifdefs. |
f6081a04 JS |
415 | |
416 | This works quite well: at the end of the program, all leaked blocks with their | |
417 | malloc count are shown. This number (malloc count) can be used to determine | |
8b283bb8 | 418 | where exactly the object was allocated: for this it's enough to set the variable |
f6081a04 JS |
419 | _crtBreakAlloc (look in VC98\crt\srs\dbgheap.c line 326) to this number and |
420 | a breakpoint will be triggered when the block with this number is allocated. | |
421 | ||
422 | For simple situations it works like a charm. For something more complicated | |
423 | like reading uninitialized memory a specialized tool is probably better... | |
424 | ||
425 | Regards, | |
426 | VZ | |
427 | </pre> | |
428 | ||
8b283bb8 JS |
429 | <P> |
430 | ||
431 | <H3><a name="shortcutproblem">Why are menu hotkeys or shortcuts not working in my application?</a></H3> | |
432 | ||
433 | This can happen if you have a child window intercepting EVT_CHAR events and swallowing | |
434 | all keyboard input. You should ensure that event.Skip() is called for all input that | |
2b5f62a0 VZ |
435 | isn'used by the event handler.<P> |
436 | ||
437 | It can also happen if you append the submenu to the parent | |
438 | menu {\it before} you have added your menu items. Do the append {\it after} adding | |
439 | your items, or accelerators may not be registered properly.<P> | |
8b283bb8 | 440 | |
4e4dc03d JS |
441 | <H3><a name="#regconfig">Why can I not write to the HKLM part of the registry with wxRegConfig?</a></H3> |
442 | ||
443 | Currently this is not possible because the wxConfig family of classes is | |
444 | supposed to deal with per-user application configuration data, and HKLM is | |
15a2de7e | 445 | only supposed to be writeable by a user with Administrator privileges. In theory, |
4e4dc03d | 446 | only installers should write to HKLM. This is still a point debated by the |
c140b7e7 | 447 | wxWidgets developers. There are at least two ways to work around it if you really |
4e4dc03d JS |
448 | need to write to HKLM.<P> |
449 | ||
450 | First, you can use wxRegKey directly, for example: | |
451 | ||
452 | <pre> | |
453 | wxRegKey regKey; | |
454 | ||
455 | wxString idName(wxT("HKEY_LOCAL_MACHINE\\SOFTWARE\\My Company\\My Product\\Stuff\\")); | |
456 | idName += packid; | |
457 | ||
458 | regKey.SetName(idName); | |
459 | ||
460 | { | |
966a4a52 | 461 | wxLogNull dummy; |
4e4dc03d JS |
462 | if (!regKey.Create()) |
463 | { | |
464 | idName = wxT("HKEY_CURRENT_USER\\SOFTWARE\\My Company\\My Product\\Stuff\\"); | |
465 | idName += packid; | |
466 | regKey.SetName(idName); | |
467 | if (!regKey.Create()) | |
468 | return FALSE; | |
469 | } | |
470 | } | |
471 | ||
472 | if (!regKey.SetValue(wxT("THING"), (long) thing)) err += 1; | |
473 | ||
474 | regKey.Close(); | |
475 | ||
476 | </pre> | |
477 | ||
478 | Or, you can employ this trick suggested by Istvan Kovacs: | |
479 | ||
480 | <pre> | |
481 | class myGlobalConfig : public wxConfig | |
482 | { | |
483 | myGlobalConfig() : | |
484 | wxConfig ("myApp", "myCompany", "", "", wxCONFIG_USE_GLOBAL_FILE) | |
485 | {}; | |
486 | bool Write(const wxString& key, const wxString& value); | |
487 | } | |
488 | ||
489 | bool myGlobalConfig::Write (const wxString& key, const wxString& value) | |
490 | { | |
491 | wxString path = wxString ("SOFTWARE\\myCompany\\myApp\\") + wxPathOnly(key); | |
492 | wxString new_path = path.Replace ("/", "\\", true); | |
493 | wxString new_key = wxFileNameFromPath (key); | |
494 | LocalKey().SetName (wxRegKey::HKLM, path); | |
495 | return wxConfig::Write (new_key, value); | |
496 | } | |
497 | </pre> | |
f6081a04 | 498 | |
c2d48b36 JS |
499 | <H3><a name="#access">Is MS Active Accessibility supported?</a></H3> |
500 | ||
6f92b0bb | 501 | This is being worked on. Please see <a href="http://www.wxwidgets.org/access.htm">this page</a> |
c2d48b36 JS |
502 | for the current status. |
503 | ||
504 | <P> | |
505 | ||
d61c1a6f | 506 | |
162a956b | 507 | <h3><a name="#dspfmt">Why does Visual C++ complain about corrupted project files{/a></h3> |
d61c1a6f | 508 | |
c140b7e7 | 509 | If you have downloaded the wxWidgets sources from the cvs using a Unix cvs |
d61c1a6f JS |
510 | client or downloaded a daily snapshot in <tt>.tar.gz</tt> format, it is likely |
511 | that the project files have Unix line endings (LF) instead of the DOS ones (CR | |
512 | LF). However all versions of Visual C++ up to and including 7.1 can only open | |
513 | the files with the DOS line endings, so you must transform the files to this | |
514 | format using any of the thousands ways to do it. | |
515 | <p> | |
516 | Of course, another possibility is to always use only the Windows cvs client | |
517 | and to avoid this problem completely. | |
518 | <p> | |
519 | ||
6f92b0bb JS |
520 | <h3><a name="#crtmismatch">Visual C++ gives errors about multiply defined symbols, what can I do?</a></h3> |
521 | ||
522 | If you get errors like this | |
523 | ||
524 | <pre> | |
525 | MSVCRTD.lib(MSVCRTD.dll) : error LNK2005: _xxxxxx already defined in LIBCD.lib(yyyyy.obj) | |
526 | </pre> | |
527 | ||
528 | when linking your project, this means that you used different versions of CRT | |
529 | (C Run-Time) library for wxWindows (or possibly another library) and the main | |
530 | project. Visual C++ provides static or dynamic and multithread safe or not | |
531 | versions of CRT for each of debug and release builds, for a total of 8 | |
532 | libraries. You can choose among them by going to the "Code generation" | |
15a2de7e | 533 | page/subitem of the "C++" tab/item in the project proprieties dialog in VC6/7. |
6f92b0bb JS |
534 | <p> |
535 | To avoid problems, you <strong>must</strong> use the same one for all | |
536 | components of your project. wxWindows uses multithread safe DLL version of the | |
537 | CRT which is a good choice but may be problematic when distributing your | |
538 | applications if you don't include the CRT DLL in your installation -- in this | |
539 | case you may decide to switch to using a static CRT version. If you build with | |
540 | <tt>wxUSE_THREADS == 0</tt> you may also use the non MT-safe version as it is | |
541 | slightly smaller and faster. | |
542 | <p> | |
543 | But the most important thing is to use the <strong>same</strong> CRT setting for | |
544 | all components of your project. | |
545 | ||
8d7ea231 | 546 | <h3><a name="#directx">Why do I get compilation errors when using wxWidgets with DirectShow?</a></h3> |
09e7b3a0 JS |
547 | |
548 | If you get errors when including Microsoft DirectShow or DirectDraw headers, | |
549 | the following message from Peter Whaite could help: | |
8d7ea231 | 550 | <blockquote><pre> |
09e7b3a0 JS |
551 | > This causes compilation errors within DirectShow: |
552 | > | |
553 | > wxutil.h(125) : error C2065: 'EXECUTE_ASSERT' : undeclared identifier | |
554 | > amfilter.h(1099) : error C2065: 'ASSERT' : undeclared identifier | |
555 | ||
556 | The reason for this is that __WXDEBUG__ is also used by the DXSDK (9.0 | |
557 | in my case) to '#pragma once' the contents of | |
558 | DXSDK/Samples/C++/DirectShow/BaseClasses/wxdebug.h. So if __WXDEBUG__ | |
559 | is defined, then wxdebug.h doesn't get included, and the assert macros | |
560 | don't get defined. You have to #undef __WXDEBUG__ before including the | |
561 | directshow baseclass's <streams.h>. | |
8d7ea231 | 562 | </pre></blockquote> |
09e7b3a0 | 563 | |
162a956b | 564 | |
09e7b3a0 JS |
565 | <h3><a name="#handlewm">How do I handle Windows messages in my wxWidgets program?</a></h3> |
566 | ||
567 | To handle a Windows message you need to override a virtual | |
568 | <tt>MSWWindowProc()</tt> method in a wxWindow-derived class. You should then | |
569 | test if <tt>nMsg</tt> parameter is the message you need to process and perform | |
570 | the necessary action if it is or call the base class method otherwise. | |
571 | ||
572 | ||
ce3ed50d JS |
573 | </font> |
574 | ||
575 | </BODY> | |
576 | ||
577 | </HTML> |