wxWidgets 2 FAQ

From 57d9fc8522615042a987d8f69f8991ce87e498a3 Mon Sep 17 00:00:00 2001 From: Julian Smart Date: Tue, 20 Sep 2005 09:09:20 +0000 Subject: [PATCH] Updated FAQ from web files git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@35608 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775 --- docs/html/faq.htm | 4 +-- docs/html/faqgen.htm | 41 ++++++++++------------ docs/html/faqgtk.htm | 15 ++++---- docs/html/faqmac.htm | 60 ++++++++++++++++---------------- docs/html/faqmot.htm | 4 +-- docs/html/faqmsw.htm | 82 ++++++++++++++++++++++---------------------- docs/html/faqx11.htm | 4 +-- 7 files changed, 103 insertions(+), 107 deletions(-) diff --git a/docs/html/faq.htm b/docs/html/faq.htm index 6891ff9b4c..2c5af9213c 100644 --- a/docs/html/faq.htm +++ b/docs/html/faq.htm @@ -2,7 +2,7 @@ -wxWidgets 2 FAQ +wxWidgets FAQ @@ -13,7 +13,7 @@ -wxWidgets 2 FAQ +wxWidgets FAQ diff --git a/docs/html/faqgen.htm b/docs/html/faqgen.htm index 90f2c41d1a..64144dcaac 100644 --- a/docs/html/faqgen.htm +++ b/docs/html/faqgen.htm @@ -1,7 +1,8 @@ + -wxWidgets 2 FAQ: General +wxWidgets FAQ: General @@ -12,7 +13,7 @@ -wxWidgets 2 FAQ: General +wxWidgets FAQ: General @@ -25,7 +26,7 @@ See also top-level FAQ page.

List of questions in this category

What is wxWidgets?
Can I use wxWidgets 2 for both proprietary projects, and GPL'ed projects?
Can I use wxWidgets for both proprietary projects, and GPL'ed projects?
Is there support?
Who uses wxWidgets?
What platforms are supported by wxWidgets?

top-level FAQ page

How to use C++ exceptions with wxWidgets?
How is wxWidgets being developed?
How is wxWidgets distributed?
What is wxBase?
What is wxUniversal?
What about Java?

DialogBlocks

Useful Tools

-You don't have to use C++ to use wxWidgets: there is a Python interface for wxWidgets 2, +You don't have to use C++ to use wxWidgets: there is a Python interface for wxWidgets, and also a Perl interface.

Can I use wxWidgets 2 for both proprietary (commercial) projects, and GPL'ed projects?

Can I use wxWidgets for both proprietary (commercial) projects, and GPL'ed projects?

licence

-The conditions for using wxWidgets 2 are the same whether you are a personal, academic +The conditions for using wxWidgets are the same whether you are a personal, academic or commercial developer.

@@ -91,7 +94,7 @@ Our highest-profile user yet is industry veteran and Lotus Corp. founder Mitch K and his Open Source Applications Foundation.

What platforms are supported by wxWidgets 2?

What platforms are supported by wxWidgets?

Windows 3.1, Windows 95/98, Windows NT, Windows 2000, Windows ME. @@ -104,7 +107,7 @@ on OS/2.

How does wxWidgets 2 support platform-specific +
How does wxWidgets support platform-specific features?
This is a hotly-debated topic amongst the developers. My own philosophy @@ -130,7 +133,7 @@ of today's sophisticated applications.
Currently resources such as bitmaps and icons are handled in a platform-specific way, but it is hoped to reduce this dependence in due course.
-Another reason why wxWidgets 2 is not a 'lowest common denominator' toolkit is that +Another reason why wxWidgets is not a 'lowest common denominator' toolkit is that some functionality missing on some platform has been provided using generic, platform-independent code, such as the wxTreeCtrl and wxListCtrl classes.
@@ -142,7 +145,7 @@ templates adequately so it would dramatically reduce the number of compilers and platforms that could be supported. It would also be undesirable to make wxWidgets dependent on another large library that may have to be downloaded and installed. In addition, use of templates can lead to executable bloat, which is something -wxWidgets 2 is strenuously trying to avoid.
+wxWidgets is strenuously trying to avoid.
The standard C++ string class is not used, again because it is not available to all compilers, and it is not necessarily a very efficient implementation. Also, we retain more flexibility @@ -163,7 +166,7 @@ or by adding this to a header before you include any STL files:

-

Is there a rich edit/markup widget for wxWidgets 2?

Is there a rich edit/markup widget for wxWidgets?

@@ -225,22 +228,14 @@ If you are feeling adventurous, you may also check out the sources directly from cvs.

What is wxBase?

wxWidgets 2 for GTK FAQ

wxWidgets for GTK FAQ

-wxWidgets 2 for GTK FAQ +wxWidgets for GTK FAQ

-See also top-level FAQ page +See also top-level FAQ page and Unix FAQ page.

List of questions in this category

What is wxWidgets 2 for GTK+?
What is wxWidgets for GTK+?
Why doesn't reading floating point numbers work when using wxWidgets?
Does wxGTK have GNOME support?
Warning about GTK libraries supplied with RedHat

Unix FAQ page

What is wxWidgets 2 for GTK?

What is wxWidgets for GTK?

GTK+ toolkit

here

diff --git a/docs/html/faqmac.htm b/docs/html/faqmac.htm index 6c053adb95..eb10289a07 100644 --- a/docs/html/faqmac.htm +++ b/docs/html/faqmac.htm @@ -2,7 +2,7 @@ -wxWidgets 2 for Mac FAQ +wxWidgets for Mac FAQ @@ -13,7 +13,7 @@ -wxWidgets 2 for Mac FAQ +wxWidgets for Mac FAQ @@ -27,12 +27,13 @@ See also top-level FAQ page.

Where should I download wxMac from?
Which Mac platforms are supported?
How is the Mac OS X port different from the Classic Mac OS port?
How are improvements to the Classic Mac OS port integrated into the Mac OS X port?
What compilers are supported?
What can I do if I get conflicts between different installed versions of wxWidgets?
How does CVS handle file types/creators under Mac OS 8.x /9.x?
How does CVS handle file types/creators under Mac OS X?
What steps are required to build wxMac using CodeWarrior P ro 5.3?
What steps are required to build wxMac under Mac OS X?
What important settings are required in the CodeWarrior Project Preferences?
What are the smart preprocessing errors with the Apple Developer Tools?

top-level FAQ page

Where should I download wxMac from?

downloads page

CVS trunk

development snapshot

The author of this port is Stefan Csomor.

Which Mac platforms are supported?

-A Mac OS X port is in progress in order to be able to build wxWidgets applications using the Apple Developer Tools that are delivered with every copy of Mac OS X. -The Mac OS X port is based on and, for the most part, merged with the Carbon code for Classic Mac OS. +wxWidgets can be used to develop and deliver applications on Mac OS X and Mac Classic (e.g. Mac OS 8.x/9.x) both as Carbon and non-Carbon applications. +However the Mac OS X port is the most actively developed one, and Mac Classic will not be supported +after 2.6. wxMac works best with Mac OS X 10.3 and above.

How is the Mac OS X port different from the Classic Mac OS port?

What compilers are supported?

-This hybrid approach was suggested by Apple to the Fizzilla team working on Mozilla for Mac OS X. +Under Mac OS X, the Developer Tools are sufficient to build wxMac. CodeWarrior Pro 6 can also be used to build the Carbon targets.

How are improvements to the Classic Mac OS port integrated into the Mac OS X port?

-The following points should be considered when improving wxMac: -

Non Carbon compliant changes for Classic Mac OS will most likely break the Mac OS X port. Such changes should be tested using the Carbon targets in the CodeWarrior projects for Classic Mac OS. -
Non Carbon compliant changes for Mac OS X will most likely break the Classic Mac OS port. Such changes should be tested using CodeWarrior under Mac OS 8.x/9.x. -

What can I do if I get conflicts between different installed versions of wxWidgets?

What compilers are supported?

-Under Classic Mac OS, MetroWerks CodeWarrior Pro 5.3 or 6 are required to build wxMac. -

-Under Mac OS X, the Developer Tools are sufficient to build wxMac. CodeWarrior Pro 6 can also be used to build the Carbon targets. -

+I got it to work. I removed the original wxMac build-release folder +and recompiled wxMac following instructions in your book. I then ran +"sudo make install" which I didn't do the first time. I figured I +could now run wx-config --cxxflags from my home directory because +/usr/local/bin/wx-config was in my $PATH. However, OSX 10.4 installed +a version of wxWidgets. When I ran wx-config I was getting wx 2.5 +libs instead of the 2.6.1 libs I just compiled. When I ran +"/usr/local/bin/wx-config --cxxflags" and "/usr/local/bin/wx-config --libs" +and pasted that output into XCode preferences, everything worked fine. +

How does CVS handle file types/creators under Mac OS 8.x/9.x?

What steps are required to build wxMac under Mac OS X?

wxWidgets 2 for Motif FAQ

wxWidgets for Motif FAQ

-wxWidgets 2 for Motif FAQ +wxWidgets for Motif FAQ

wxWidgets 2 for Windows FAQ

wxWidgets for Windows FAQ

-wxWidgets 2 for Windows FAQ +wxWidgets for Windows FAQ

top-level FAQ page

What about Windows CE?
What do I need to do for Windows XP?
What compilers are supported?
Which is the best compiler to use with wxWidgets 2?
Which is the best compiler to use with wxWidgets?
Is Unicode supported?
Does wxWidgets support double byte fonts (Chinese/Japanese/Korean etc.)?
Can you compile wxWidgets 2 as a DLL?
Can you compile wxWidgets as a DLL?
How can I reduce executable size?
Is wxWidgets compatible with MFC?
Why do I get errors about setup.h not being found?

top-level FAQ page

Which Windows platforms are supported?

+wxWidgets can be used to develop and deliver applications on Windows 95, Windows 98, Windows NT, +Windows 2000, Windows XP, and Windows Vista. A Windows CE +port is also available (see below).

-wxWidgets 2 is designed to make use of WIN32 features and controls. However, unlike Microsoft, -we have not forgotten users of 16-bit Windows. Most features -work under Windows 3.1, including wxTreeCtrl and wxListCtrl using the generic implementation. -However, don't expect very Windows-95-specific classes to work, such as wxTaskBarIcon. The wxRegConfig -class doesn't work either because the Windows 3.1 registry is very simplistic. Check out the 16-bit -makefiles to see what other files have been left out. -

-16-bit compilation is supported under Visual C++ 1.5, and Borland BC++ 4 to 5. +16-bit compilation is only supported for wxWidgets 2.4 and previous versions, +using Visual C++ 1.5 and Borland BC++ 4 to 5.

-wxWidgets 2 for Windows will also compile on Unix with gcc using Wine from WineHQ. +wxWidgets for Windows will also compile on Unix with gcc using Wine from WineHQ. The resulting executables are Unix binaries that work with the Wine Windows API emulator.

-You can also compile wxWidgets 2 for Windows on Unix with Cygwin or Mingw32, resulting +You can also compile wxWidgets for Windows on Unix with Cygwin or Mingw32, resulting in executables that will run on Windows. So in theory you could write your applications using wxGTK or wxMotif, then check/debug your wxWidgets for Windows programs with Wine, and finally produce an ix86 Windows executable using Cygwin/Mingw32, @@ -78,10 +73,19 @@ without ever needing a copy of Microsoft Windows. See the Technical Note on the

What about Windows CE?

wxEmbedded

+This port supports Pocket PC 2002/2003 and MS Smartphone 2002/2003, using +Embedded Visual C++ 3 or 4. For further information, see the wxMSW section in +the wxWidgets Reference Manual, and also the wxEmbedded page.

What do I need to do for Windows XP?

+ +For versions of wxWidgets below 2.5, you need to provide the manifest +explicitly, as follows.

+ In the same directory as you have your executable (e.g. foo.exe) you put a file called foo.exe.manifest in which you have something like the following: @@ -119,10 +123,6 @@ line:

1 24 "winxp.manifest" -In wxWidgets 2.5, this will be in the wx/msw/wx.rc and -so will happen automatically so long as you include wx.rc -in your own .rc file.

- For an explanation of this syntax, please see this article. @@ -130,7 +130,7 @@ article.

What compilers are supported?

Which is the best compiler to use with wxWidgets 2?

Which is the best compiler to use with wxWidgets?

@@ -170,7 +170,8 @@ Watcom C++ is a little slow and the debugger is not really up to today's sta Among the free compilers the best choice seem to be Borland C++ command line tools and mingw32 (port of gcc to Win32). Both of them are supported by -wxWidgets. +wxWidgets. However BC++ has trouble compiling large executables statically, +so you need to dynamically link the wxWidgets libraries.

-or if building the static Release library, lib/msw.

+or if building the static Release library, lib/vc_lib/msw.

See also the wxWiki Contents for more information.

@@ -323,13 +324,12 @@ Code' (and no others). This will then work.

How are the wxWidgets makefiles edited under Windows?

+is described in technical note 16 under docs/tech in your distribution.

-As of wxWidgets 2.1, there is a new system written by Vadim Zeitlin, that +For 2.4.x, there is a system written by Vadim Zeitlin that generates the makefiles from templates using tmake.

-Here are Vadim's notes:

+Here are Vadim's notes on tmake:

To use these new makefiles, you don't need anything (but see below). @@ -341,7 +341,7 @@ example) and regenerate the makefile using tmake.
tmake can be found at www.troll.no/freebies/tmake.html. -It's a Perl5 program and so it needs Perl (doh). There is a binary for +It's a Perl5 program and so it needs Perl (doh). There is a binary for Windows (available from the same page), but I haven't used it, so I don't know if it works as flawlessly as "perl tmake" does (note for people knowing Perl: don't try to run tmake with -w, it won't @@ -350,7 +350,7 @@ just go to distrib/msw/tmake and type
tmake -t b32 wxwin.pro -o ../../src/msw/makefile.b32
-The makefiles are untested - I don't have any of Borland, Watcom or +The makefiles are untested - I don't have any of Borland, Watcom or Symantec and I don't have enough diskspace to recompile even with VC6 using makefiles. The new makefiles are as close as possible to the old ones, but not closer: in fact, there has been many strange things @@ -457,7 +457,7 @@ First, you can use wxRegKey directly, for example: regKey.SetName(idName); { - wxLogNull dummy; + wxLogNull dummy; if (!regKey.Create()) { idName = wxT("HKEY_CURRENT_USER\\SOFTWARE\\My Company\\My Product\\Stuff\\"); @@ -542,7 +542,7 @@ slightly smaller and faster. But the most important thing is to use the same CRT setting for all components of your project. -
Why do I get compilation erros when using wxWidgets with DirectShow?
+
Why do I get compilation errors when using wxWidgets with DirectShow?
If you get errors when including Microsoft DirectShow or DirectDraw headers, the following message from Peter Whaite could help: @@ -554,9 +554,9 @@ the following message from Peter Whaite could help: The reason for this is that __WXDEBUG__ is also used by the DXSDK (9.0 in my case) to '#pragma once' the contents of -DXSDK/Samples/C++/DirectShow/BaseClasses/wxdebug.h. So if __WXDEBUG__ +DXSDK/Samples/C++/DirectShow/BaseClasses/wxdebug.h. So if __WXDEBUG__ is defined, then wxdebug.h doesn't get included, and the assert macros -don't get defined. You have to #undef __WXDEBUG__ before including the +don't get defined. You have to #undef __WXDEBUG__ before including the directshow baseclass's <streams.h>.

wxWidgets 2 for X11 FAQ

wxWidgets for X11 FAQ

-wxWidgets 2 for X11 FAQ +wxWidgets for X11 FAQ