]> git.saurik.com Git - wxWidgets.git/blobdiff - docs/html/faqgen.htm
fill wxFocusEvent::m_win properly
[wxWidgets.git] / docs / html / faqgen.htm
index e0f0fc66737865afb0f3864116cb2d95f6ffa6fa..0c14ce0fe1762007d0fcc6de2137aa2ee2533495 100644 (file)
@@ -1,3 +1,4 @@
+
 <HTML>
 
 <HEAD>
 <HTML>
 
 <HEAD>
@@ -8,10 +9,10 @@
 
 <font face="Arial, Lucida Sans, Helvetica">
 
 
 <font face="Arial, Lucida Sans, Helvetica">
 
-<table width=100% border=4 cellpadding=5 cellspacing=0>
+<table width=100% border=0 cellpadding=5 cellspacing=0>
 <tr>
 <tr>
-<td bgcolor="#660000">
-<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<td bgcolor="#C4ECF9">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#000000">
 wxWindows 2 FAQ: General
 </font>
 </td>
 wxWindows 2 FAQ: General
 </font>
 </td>
@@ -22,21 +23,38 @@ wxWindows 2 FAQ: General
 
 See also <a href="faq.htm">top-level FAQ page</a>.
 <hr>
 
 See also <a href="faq.htm">top-level FAQ page</a>.
 <hr>
+<h3>List of questions in this category</h3>
+<ul>
+<li><a href="#whatis">What is wxWindows?</a></li>
+<li><a href="#users">Who uses wxWindows?</a></li>
+<li><a href="#platforms">What platforms are supported by wxWindows 2?</a></li>
+<li><a href="#specific">How does wxWindows 2 support platform-specific features?</a></li>
+<li><a href="#stl">Does wxWindows use STL? or the standard string class?</a></li>
+<li><a href="#richedit">Is there a rich edit/markup widget for wxWindows 2?</a></ li>
+<li><a href="#dev">How is wxWindows 2 being developed?</a></li>
+<li><a href="#distrib">How is wxWindows 2 distributed?</a></li>
+<li><a href="#future">What are the plans for the future?</a></li>
+<li><a href="#univ">What is wxUniversal?</a></li>
+<li><a href="#jave">What about Java?</a></li>
+<li><a href="#help">How can I help the project?</a></li>
+</ul>
+<hr>
 
 <H3><a name="whatis">What is wxWindows?</a></H3>
 
 wxWindows is a class library that allows you to compile graphical C++ programs on a range of
 different platforms. wxWindows defines a common API across platforms, but uses the native graphical user interface (GUI) on each platform,
 
 <H3><a name="whatis">What is wxWindows?</a></H3>
 
 wxWindows is a class library that allows you to compile graphical C++ programs on a range of
 different platforms. wxWindows defines a common API across platforms, but uses the native graphical user interface (GUI) on each platform,
-so your program will take on the native 'look and feel' that users are familiar with.<P>
+so your program will take on the native &#39;look and feel&#39; that users are familiar with.<P>
 
 Although GUI applications are mostly built programmatically, there is a dialog editor to help
 
 Although GUI applications are mostly built programmatically, there is a dialog editor to help
-build attractive dialogs and panels.<P>
+build attractive dialogs and panels. Robert Roebling&#39;s <a href="http://www.roebling.com">wxDesigner</a>
+makes light work of resizable, portable dialogs.<P>
 
 
-You don't have to use C++ to use wxWindows: wxWindows 1 has been interfaced to several interpreted languages,
-such as CLIPS, Python, Scheme, XLisp and Perl, and there is a Python interface for wxWindows 2.
+You don&#39;t have to use C++ to use wxWindows: there is a <a href="http://wxpython.org">Python interface</a> for wxWindows 2,
+and also a <a href="http://wxperl.sourceforge.net" target=_top>Perl interface</a>.
 <P>
 
 <P>
 
-<h3>Can I use wxWindows 2 for both proprietary (commercial) projects, and GPL'ed projects?</h3>
+<h3>Can I use wxWindows 2 for both proprietary (commercial) projects, and GPL&#39;ed projects?</h3>
 
 Yes. Please see the <a href="newlicen.htm">licence</a> for details, but basically
 you can distribute proprietary binaries without distributing any source code, and neither will wxWindows
 
 Yes. Please see the <a href="newlicen.htm">licence</a> for details, but basically
 you can distribute proprietary binaries without distributing any source code, and neither will wxWindows
@@ -56,97 +74,36 @@ keen to fix bugs as soon as possible, though obviously there are no guarantees.
 <H3><a name="users">Who uses wxWindows?</a></H3>
 
 Many organisations - commercial, government, and academic - across the
 <H3><a name="users">Who uses wxWindows?</a></H3>
 
 Many organisations - commercial, government, and academic - across the
-world. It's impossible to estimate the true number of users, since
+world. It&#39;s impossible to estimate the true number of users, since
 wxWindows is obtained by many different means, and we cannot monitor
 distribution. The mailing list contains around 300-400 entries which is
 quite large for a list of this type.<P>
 
 wxWindows is obtained by many different means, and we cannot monitor
 distribution. The mailing list contains around 300-400 entries which is
 quite large for a list of this type.<P>
 
-<H3>I am about to start a wxWindows 1.xx project. Should I use 2 instead?</H3>
-
-wxWindows 2 is still in beta but it's actually pretty useable (Windows, GTK, Motif).<P>
+See <a href="users.htm">Users</a> for a list of some users and their applications, and
+also <A href="feedback.htm">Feedback</a> for comments.<P>
 
 
-Porting to wxWindows 2 from 1.xx will not be too painful; see the next question
-for ways in which you can make it easier.<P>
-
-<H3>Why would I want to use wxWindows 2 in preference to wxWindows 1.xx?</H3>
-
-Some reasons:
+<H3><a name="platforms">What platforms are supported by wxWindows 2?</a></H3>
 
 <ul>
 
 <ul>
-<li>In 2 there is far more flexibility, for example in the way windows can be
-nested, and the way events are intercepted.
-<li>There is more functionality for producing sophisticated applications,
-for example using the wxTreeCtrl and wxListCtrl classes.
-<li>There is better C++-conformance (such as usage of wxString and const) which
-will make your applications more reliable and easier to maintain.
-<li>wxWindows 2 will be better supported than 1.xx.
-<li>The GTK version is attractive for people interested in writing Linux and GNOME
-applications.
-<li>The Mac version will be one of the best frameworks available on that platform.
-</ul>
-
-<H3>How can I prepare for wxWindows 2?</H3>
-
-To make porting to wxWindows 2 easier in the future, take a look at some
-<a href="http://web.ukonline.co.uk/julian.smart/wxwin/prepare.htm">tips</a> for writing existing code in a 2-compatible way.<P>
-
-<H3>How much has the API changed since 1.xx?</H3>
-
-It's difficult to summarize, but some aspects haven't changed very much. For example, if you have some
-complex drawing code, you will mostly need to make sure it's parameterised with a device
-context (instead of obtaining one from a window or storing it). You won't have
-to completely rewrite the drawing code.<P>
-
-The way that events are handled has changed, so for example, where you overrode
-OnSize before, you now have a non-virtual OnSize with a single event class argument.
-To make this function known to wxWindows, you add an entry in an 'event table' using macros. Addition of these macros
-will eventually be made easier by a tool which will allow selection from a list
-and copy-and-paste into your editor. This is extended to button presses, listbox selection
-etc. so callbacks have gone (they may be added back for limited backward compatibility).<P>
-
-The class hierarchy has changed to allow greater flexibility but it probably won't affect your
-existing application. One exception to this is MDI applications which now use separate MDI classes instead of style
-flags. As a result, it won't be possible to switch between MDI and SDI operation at run-time
-without further coding, but a benefit is less interdependence between areas of code,
-and therefore smaller executable size.<P>
-
-Panel items (now called controls) no longer have labels associated with most of them,
-and default panel layout has been removed. The idea is that you make greater use
-of dialog resources, for better-looking dialogs.<P>
-
-<H3>What classes have disappeared?</H3>
-
-wxForm, wxTextWindow (subsumed into wxTextCtrl).
-
-<H3>Does wxWindows 2 mean that wxWindows 1.xx is dead?</H3>
-
-While wxWindows 2 is being developed, there will be further patches to wxWindows 1.xx.
-Obviously we are investing most of our energy into the new code, but we're also trying
-to fix bugs in the current version.<P>
-
-<H3>What platforms will be supported by wxWindows 2?</H3>
-
-<ul>
-<li>Windows 3.1, Windows 95/98, Windows NT;
-<li>Linux and other Unix platforms with GTK+;
-<li>Unix with Motif or the free Motif clone Lesstif;
-<li>Mac (coming later in 1999);
-<li>A BeOS port is being investigated.
-<li>A Windows CE port is being investigated.
-<li>There are no plans to support OS/2 or XView. However,
-you may be able to compile the GTK and Motif versions under OS/2 with X and GTK
-installed, or the Windows version with IBM's Open32 extensions.
+<li>Windows 3.1, Windows 95/98, Windows NT, Windows 2000, Windows ME.
+<li>Linux and other Unix platforms with GTK+.
+<li>Unix with Motif or the free Motif clone Lesstif.
+<li>Mac OS.
+<li>Embedded platforms are being investigated. See the <a href="wxuniv.htm">wxUniversal</a> project.
+<li>An OS/2 port is in progress, and you can also compile wxWindows for GTK+ or Motif
+on OS/2.
 </ul>
 <P>
 
 </ul>
 <P>
 
-<H3>How does wxWindows 2 support platform-specific features?</H3>
+<H3><a name="specific">How does wxWindows 2 support platform-specific
+features?</a></H3>
 
 This is a hotly-debated topic amongst the developers. My own philosophy
 is to make wxWindows as platform-independent as possible, but allow in a
 few classes (functions, window styles) that are platform-specific.
 For example, Windows metafiles and Windows 95 taskbar icons have
 their own classes on Windows, but nowhere else. Because these classes
 
 This is a hotly-debated topic amongst the developers. My own philosophy
 is to make wxWindows as platform-independent as possible, but allow in a
 few classes (functions, window styles) that are platform-specific.
 For example, Windows metafiles and Windows 95 taskbar icons have
 their own classes on Windows, but nowhere else. Because these classes
-are provided and are wxWindows-compatible, it doesn't take much
+are provided and are wxWindows-compatible, it doesn&#39;t take much
 coding effort for an application programmer to add support for
 some functionality that the user on a particular platform might otherwise
 miss. Also, some classes that started off as platform-specific, such
 coding effort for an application programmer to add support for
 some functionality that the user on a particular platform might otherwise
 miss. Also, some classes that started off as platform-specific, such
@@ -154,24 +111,24 @@ as the MDI classes, have been emulated on other platforms. I can imagine
 that even wxTaskBarIcon may be implemented for Unix desktops one day.
 <P>
 
 that even wxTaskBarIcon may be implemented for Unix desktops one day.
 <P>
 
-In other words, wxWindows is not a 'lowest common denominator' approach,
+In other words, wxWindows is not a &#39;lowest common denominator&#39; approach,
 but it will still be possible to write portable programs using the
 core API. Forbidding some platform-specific classes would be a stupid
 approach that would alienate many potential users, and encourage
 the perception that toolkits such as wxWindows are not up to the demands
 but it will still be possible to write portable programs using the
 core API. Forbidding some platform-specific classes would be a stupid
 approach that would alienate many potential users, and encourage
 the perception that toolkits such as wxWindows are not up to the demands
-of today's sophisticated applications.<P>
+of today&#39;s sophisticated applications.<P>
 
 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.<P>
 
 
 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.<P>
 
-Another reason why wxWindows 2 is not a 'lowest common denominator' toolkit is that
+Another reason why wxWindows 2 is not a &#39;lowest common denominator&#39; toolkit is that
 some functionality missing on some platform has been provided using generic,
 platform-independent code, such as the wxTreeCtrl and wxListCtrl classes.<P>
 
 some functionality missing on some platform has been provided using generic,
 platform-independent code, such as the wxTreeCtrl and wxListCtrl classes.<P>
 
-<H3>Does wxWindows use STL? or the standard string class?</H3>
+<H3><a name="stl">Does wxWindows use STL? or the standard string class?</a></H3>
 
 No. This is a much-discussed topic that has (many times) ended with the conclusion that it is in
 
 No. This is a much-discussed topic that has (many times) ended with the conclusion that it is in
-wxWindows' best interests to avoid use of templates. Not all compilers can handle
+wxWindows&#39; best interests to avoid use of templates. Not all compilers can handle
 templates adequately so it would dramatically reduce the number of compilers
 and platforms that could be supported. It would also be undersirable to make
 wxWindows dependent on another large library that may have to be downloaded and installed.
 templates adequately so it would dramatically reduce the number of compilers
 and platforms that could be supported. It would also be undersirable to make
 wxWindows dependent on another large library that may have to be downloaded and installed.
@@ -184,28 +141,64 @@ by being able to modify our own string class. Some compatibility with the string
 has been built into wxString.<P>
 
 There is nothing to stop an application using templates or the string class for its own
 has been built into wxString.<P>
 
 There is nothing to stop an application using templates or the string class for its own
-purposes.<P>
+purposes. With wxWindows debugging options on, you may find you get errors when including
+STL headers. You can work around it either by switching off memory checking,
+or by adding this to a header before you include any STL files:<P>
+
+<PRE>
+&#35;ifdef new
+&#35;undef new
+&#35;endif
+</PRE>
+
+<P>
+
+
+<H3><a name="richedit">Is there a rich edit/markup widget for wxWindows 2?</a></H3>
+
+These are the possibilities so far:<P>
 
 
-<H3>How is wxWindows 2 being developed?</H3>
+<ul>
+<li>The richedit sample has a text editor that does markup.
+<li>See <a href="http://www.scintilla.org" target=_top>www.scintilla.org</a> for
+a very nice syntax-highlighting editor widget. Robin Dunn is writing a wxWindows wrapper
+for this widget.
+<li>If you only need to display marked-up information, rather than edit it,
+then wxHTML will suit your needs. wxHTML is built into wxWindows - please see the reference
+manual for details, and samples/html.
+<li>There are rich edit widgets in both WIN32 and GTK+, but there is currently
+no wxWindows wrapper for these (but text attribute functions are being added in the wxWindows 2.3.x series).
+</ul>
+
+<P>
+
+<H3><a name="dev">How is wxWindows 2 being developed?</a></H3>
 
 We are using the <a href="cvs.htm">CVS</a> system to develop and maintain wxWindows. This allows
 
 We are using the <a href="cvs.htm">CVS</a> system to develop and maintain wxWindows. This allows
-us to make alterations and upload them instantly to the server in Edinburgh, from
+us to make alterations and upload them instantly to the SourceForge server, from
 which others can update their source.<P>
 
 which others can update their source.<P>
 
-<H3>How is wxWindows 2 distributed?</H3>
+To build source from CVS, see the file BuildCVS.txt in the top-level wxWindows distribution
+directory.<P>
 
 
-By ftp, and via the <a href="cdrom2.htm">wxWindows CD-ROM</a>.<P>
+<H3><a name="distrib">How is wxWindows 2 distributed?</a></H3>
 
 
-<H3>What are the plans for the future?</H3>
+By ftp, and via the <a href="cdrom2.htm">wxWindows CD-ROM</a>.
+<P>
+If you are feeling adventurous, you may also check out the sources directly
+from the <a href="cvs.htm">cvs</a>
+<p>
+
+<H3><a name="future">What are the plans for the future?</a></H3>
 
 
-Currently we're working too hard on getting wxWindows 2 finished (are GUI toolkits ever
+Currently we&#39;re working too hard on getting wxWindows 2 finished (are GUI toolkits ever
 finished?) to think very far ahead. However, we know we want to make wxWindows as robust
 and well-publicised as possible. We also want to aim for better platform-independence of
 resources such as icons and bitmaps, standardising on the PNG for all platforms.<P>
 
 finished?) to think very far ahead. However, we know we want to make wxWindows as robust
 and well-publicised as possible. We also want to aim for better platform-independence of
 resources such as icons and bitmaps, standardising on the PNG for all platforms.<P>
 
-Other possibilities include: DCOM/CORBA compatibility; a wxWindows book; an
-<a href="http://web.ukonline.co.uk/julian.smart/wxwin/wxide.htm">IDE</a>;
-other platforms; other interface abilities such as speech output.<P>
+Other possibilities include: DCOM/CORBA compatibility; a wxWindows book;
+<a href="http://wxworkshop.sourceforge.net/">wxWorkshop</a>, an IDE;
+other platforms, especially embedded systems; other interface abilities such as speech output.<P>
 
 We will investigate the possibility of compiler or operating system vendors bundling wxWindows with
 their product.<P>
 
 We will investigate the possibility of compiler or operating system vendors bundling wxWindows with
 their product.<P>
@@ -213,17 +206,28 @@ their product.<P>
 The high-level goal of wxWindows is to be thought of as the number one C++ framework,
 for virtually any platform. Move over, MFC!<P>
 
 The high-level goal of wxWindows is to be thought of as the number one C++ framework,
 for virtually any platform. Move over, MFC!<P>
 
-<H3>What about Java?</H3>
+<H3><a name="univ">What is wxUniversal?</a></H3>
+
+wxUniversal is a new port of wxWindows being currently actively developed. The
+main difference is that wxUniversal implements all controls (or widgets) in
+wxWindows itself thus allowing to have much more flexibility (i.e. support for
+themes even under MS Windows!). It also means that it is now much easier to
+port wxWindows to a new platform as only the low-level classes must be ported
+which make for a small part of the library.
+<p>
+You may find more about wxUniversal <a href=wxuniv.htm>here</a>.
+
+<H3><a name="jave">What about Java?</a></H3>
 
 The Java honeymoon period is over :-) and people are realising that it cannot
 
 The Java honeymoon period is over :-) and people are realising that it cannot
-meet all their cross-platform development needs. We don't anticipate a major threat
+meet all their cross-platform development needs. We don&#39;t anticipate a major threat
 from Java, and the level of interest in wxWindows is as high as ever.<P>
 
 from Java, and the level of interest in wxWindows is as high as ever.<P>
 
-<H3>How can I help the project?</H3>
+<H3><a name="help">How can I help the project?</a></H3>
 
 
-Please check out the <a href="http://web.ukonline.co.uk/julian.smart/wxwin/develop.htm" target=main>Backroom</a> pages,
-in particular the <a href="http://web.ukonline.co.uk/julian.smart/wxwin/projects.htm">suggested projects</a>, and
-mail <a href="mailto:julian.smart@ukonline.co.uk">Julian Smart</a> or the developers' mailing list with your own suggestions.<P>
+Please check out the <a href="http://www.wxwindows.org/develop2.htm">Community</a> pages,
+in particular the <a href="projects.htm">suggested projects</a>, and
+mail <a href="mailto:julian.smart@btopenworld.com">Julian Smart</a> or the developers&#39; mailing list with your own suggestions.<P>
 
 </font>
 
 
 </font>