]> git.saurik.com Git - wxWidgets.git/blame - docs/html/faqgen.htm
fixed off by 1 in new GetRange() for wxTE_RICH2 controls
[wxWidgets.git] / docs / html / faqgen.htm
CommitLineData
2b5f62a0 1
ce3ed50d
JS
2<HTML>
3
4<HEAD>
5<TITLE>wxWindows 2 FAQ: General</TITLE>
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">
16<b>wxWindows 2 FAQ: General</b>
ce3ed50d
JS
17</font>
18</td>
19</tr>
20</table>
21
22<P>
23
24See 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="#whatis">What is wxWindows?</a></li>
2b5f62a0
VZ
29<li><a href="#licence">Can I use wxWindows 2 for both proprietary projects, and GPL&#39;ed projects?</a></li>
30<li><a href="#support">Is there support?</a></li>
8b283bb8 31<li><a href="#users">Who uses wxWindows?</a></li>
2b5f62a0
VZ
32<li><a href="#platforms">What platforms are supported by wxWindows?</a></li>
33<li><a href="#specific">How does wxWindows support platform-specific features?</a></li>
8b283bb8 34<li><a href="#stl">Does wxWindows use STL? or the standard string class?</a></li>
2b5f62a0 35<li><a href="#richedit">Is there a rich edit/markup widget for wxWindows?</a></ li>
53e112a0 36<li><a href="#exceptions">How to use C++ exceptions with wxWindows?</a></ li>
2b5f62a0
VZ
37<li><a href="#dev">How is wxWindows being developed?</a></li>
38<li><a href="#distrib">How is wxWindows distributed?</a></li>
8b283bb8 39<li><a href="#future">What are the plans for the future?</a></li>
2b5f62a0 40<li><a href="#base">What is wxBase?</a></li>
8b283bb8
JS
41<li><a href="#univ">What is wxUniversal?</a></li>
42<li><a href="#jave">What about Java?</a></li>
c2d48b36 43<li><a href="#dotnet">What about .NET/Mono?</a></li>
8b283bb8
JS
44<li><a href="#help">How can I help the project?</a></li>
45</ul>
46<hr>
ce3ed50d
JS
47
48<H3><a name="whatis">What is wxWindows?</a></H3>
49
50wxWindows is a class library that allows you to compile graphical C++ programs on a range of
51different platforms. wxWindows defines a common API across platforms, but uses the native graphical user interface (GUI) on each platform,
8b283bb8 52so your program will take on the native &#39;look and feel&#39; that users are familiar with.<P>
ce3ed50d 53
eb269381 54Although GUI applications are mostly built programmatically, there are several dialog editors to help
8b283bb8 55build attractive dialogs and panels. Robert Roebling&#39;s <a href="http://www.roebling.com">wxDesigner</a>
eb269381
JS
56and Anthemion Software's <a href="http://www.anthemion.co.uk/dialogblocks/" target=_new>DialogBlocks</a>
57are two commercial examples, but there are others: see the <a href="lnk_tools.htm">Useful Tools</a> page.<P>
ce3ed50d 58
8b283bb8
JS
59You don&#39;t have to use C++ to use wxWindows: there is a <a href="http://wxpython.org">Python interface</a> for wxWindows 2,
60and also a <a href="http://wxperl.sourceforge.net" target=_top>Perl interface</a>.
ce3ed50d
JS
61<P>
62
2b5f62a0 63<h3><a name="licence">Can I use wxWindows 2 for both proprietary (commercial) projects, and GPL&#39;ed projects?</a></h3>
ce3ed50d
JS
64
65Yes. Please see the <a href="newlicen.htm">licence</a> for details, but basically
66you can distribute proprietary binaries without distributing any source code, and neither will wxWindows
67conflict with GPL code you may be using or developing with it.
68<P>
69The conditions for using wxWindows 2 are the same whether you are a personal, academic
70or commercial developer.
71<P>
72
2b5f62a0 73<h3><a name="support">Is there support?</a></h3>
ce3ed50d
JS
74
75No official support, but the mailing list is very helpful and some people say that
76wxWindows support is better than for much commercial software. The developers are
77keen to fix bugs as soon as possible, though obviously there are no guarantees.
78<P>
79
80<H3><a name="users">Who uses wxWindows?</a></H3>
81
82Many organisations - commercial, government, and academic - across the
8b283bb8 83world. It&#39;s impossible to estimate the true number of users, since
ce3ed50d
JS
84wxWindows is obtained by many different means, and we cannot monitor
85distribution. The mailing list contains around 300-400 entries which is
86quite large for a list of this type.<P>
87
51ab9400
JS
88See <a href="users.htm">Users</a> for a list of some users and their applications, and
89also <A href="feedback.htm">Feedback</a> for comments.<P>
2b5f62a0
VZ
90Our highest-profile user yet is industry veteran and Lotus Corp. founder Mitch Kapor
91and his <a href="http://www.osafoundation.org" target=_new>Open Source Applications Foundation</a>.
92<P>
b953bdc2 93
8b283bb8 94<H3><a name="platforms">What platforms are supported by wxWindows 2?</a></H3>
b953bdc2
JS
95
96<ul>
8b283bb8
JS
97<li>Windows 3.1, Windows 95/98, Windows NT, Windows 2000, Windows ME.
98<li>Linux and other Unix platforms with GTK+.
99<li>Unix with Motif or the free Motif clone Lesstif.
100<li>Mac OS.
101<li>Embedded platforms are being investigated. See the <a href="wxuniv.htm">wxUniversal</a> project.
51ab9400
JS
102<li>An OS/2 port is in progress, and you can also compile wxWindows for GTK+ or Motif
103on OS/2.
b953bdc2
JS
104</ul>
105<P>
106
8b283bb8
JS
107<H3><a name="specific">How does wxWindows 2 support platform-specific
108features?</a></H3>
b953bdc2
JS
109
110This is a hotly-debated topic amongst the developers. My own philosophy
111is to make wxWindows as platform-independent as possible, but allow in a
112few classes (functions, window styles) that are platform-specific.
113For example, Windows metafiles and Windows 95 taskbar icons have
114their own classes on Windows, but nowhere else. Because these classes
8b283bb8 115are provided and are wxWindows-compatible, it doesn&#39;t take much
b953bdc2
JS
116coding effort for an application programmer to add support for
117some functionality that the user on a particular platform might otherwise
118miss. Also, some classes that started off as platform-specific, such
119as the MDI classes, have been emulated on other platforms. I can imagine
120that even wxTaskBarIcon may be implemented for Unix desktops one day.
121<P>
122
8b283bb8 123In other words, wxWindows is not a &#39;lowest common denominator&#39; approach,
b953bdc2
JS
124but it will still be possible to write portable programs using the
125core API. Forbidding some platform-specific classes would be a stupid
126approach that would alienate many potential users, and encourage
127the perception that toolkits such as wxWindows are not up to the demands
8b283bb8 128of today&#39;s sophisticated applications.<P>
b953bdc2
JS
129
130Currently resources such as bitmaps and icons are handled in a platform-specific
131way, but it is hoped to reduce this dependence in due course.<P>
132
8b283bb8 133Another reason why wxWindows 2 is not a &#39;lowest common denominator&#39; toolkit is that
b953bdc2
JS
134some functionality missing on some platform has been provided using generic,
135platform-independent code, such as the wxTreeCtrl and wxListCtrl classes.<P>
136
8b283bb8 137<H3><a name="stl">Does wxWindows use STL? or the standard string class?</a></H3>
b953bdc2
JS
138
139No. This is a much-discussed topic that has (many times) ended with the conclusion that it is in
8b283bb8 140wxWindows&#39; best interests to avoid use of templates. Not all compilers can handle
b953bdc2 141templates adequately so it would dramatically reduce the number of compilers
cd508246 142and platforms that could be supported. It would also be undersirable to make
b953bdc2
JS
143wxWindows dependent on another large library that may have to be downloaded and installed.
144In addition, use of templates can lead to executable bloat, which is something
cd508246 145wxWindows 2 is strenously trying to avoid.<P>
b953bdc2
JS
146
147The standard C++ string class is not used, again because it is not available to all compilers,
148and it is not necessarily a very efficient implementation. Also, we retain more flexibility
149by being able to modify our own string class. Some compatibility with the string class
150has been built into wxString.<P>
151
152There is nothing to stop an application using templates or the string class for its own
8b283bb8
JS
153purposes. With wxWindows debugging options on, you may find you get errors when including
154STL headers. You can work around it either by switching off memory checking,
155or by adding this to a header before you include any STL files:<P>
156
157<PRE>
158&#35;ifdef new
159&#35;undef new
160&#35;endif
161</PRE>
162
163<P>
164
b953bdc2 165
8b283bb8 166<H3><a name="richedit">Is there a rich edit/markup widget for wxWindows 2?</a></H3>
790ad94f
JS
167
168These are the possibilities so far:<P>
169
170<ul>
790ad94f 171<li>See <a href="http://www.scintilla.org" target=_top>www.scintilla.org</a> for
2b5f62a0
VZ
172a very nice syntax-highlighting editor widget. Robin Dunn has written a wxWindows wrapper
173for this widget, available in the wxWindows distribution under contrib/src/stc.
790ad94f
JS
174<li>If you only need to display marked-up information, rather than edit it,
175then wxHTML will suit your needs. wxHTML is built into wxWindows - please see the reference
176manual for details, and samples/html.
177<li>There are rich edit widgets in both WIN32 and GTK+, but there is currently
8b283bb8 178no wxWindows wrapper for these (but text attribute functions are being added in the wxWindows 2.3.x series).
790ad94f
JS
179</ul>
180
181<P>
182
53e112a0
JS
183<h3><a name="exceptions">How to use C++ exceptions with wxWindows?</a></h3>
184
185wxWindows library itself is unfortunately <i>not</i> exception-safe (as its
186initial version predates, by far, the addition of the exceptions to the C++
187language). However you can still use the exceptions in your own code and use
188the other libraries using the exceptions for the error reporting together with
189wxWindows.
190
191<p>
192There are a few issues to keep in mind, though:
193<ul>
194 <li>You shouldn&#39;t let the exceptions propagate through wxWindows code,
195 in particular you should always catch the exceptions thrown by the
196 functions called from an event handler in the handler itself and not
197 let them propagate upwards to wxWindows.
198
199 <li>You may need to ensure that the compiler support for the exceptions is
200 enabled as, considering that wxWindows itself doesn&#39;t use the
201 exceptions and turning their support on results in the library size
202 augmentation of 10% to 20%, it is turned off by default for a few
203 compilers. Moreover, for gcc (or at least its mingw version) you must
204 also turn on the RTTI support to be able to use the exceptions, so you
205 should use <tt>--disable-no_rtti --disable-no_exceptions</tt> options
206 when configuring the library (attention to the double negation).
207</ul>
208
209<p>
210
2b5f62a0 211<H3><a name="dev">How is wxWindows being developed?</a></H3>
b953bdc2
JS
212
213We are using the <a href="cvs.htm">CVS</a> system to develop and maintain wxWindows. This allows
2b5f62a0 214us to make alterations and upload them instantly to the server, from
b953bdc2
JS
215which others can update their source.<P>
216
91c93c99
JS
217To build source from CVS, see the file BuildCVS.txt in the top-level wxWindows distribution
218directory.<P>
219
2b5f62a0 220<H3><a name="distrib">How is wxWindows distributed?</a></H3>
b953bdc2 221
8b283bb8
JS
222By ftp, and via the <a href="cdrom2.htm">wxWindows CD-ROM</a>.
223<P>
224If you are feeling adventurous, you may also check out the sources directly
2b5f62a0 225from <a href="cvs.htm">cvs</a>.
8b283bb8 226<p>
b953bdc2 227
8b283bb8 228<H3><a name="future">What are the plans for the future?</a></H3>
b953bdc2 229
2b5f62a0 230Currently we&#39;re working too hard on getting wxWindows finished (are GUI toolkits ever
b953bdc2
JS
231finished?) to think very far ahead. However, we know we want to make wxWindows as robust
232and well-publicised as possible. We also want to aim for better platform-independence of
2b5f62a0 233resources such as icons and bitmaps, standardising on PNG and XPM for all platforms.<P>
b953bdc2 234
91c93c99 235Other possibilities include: DCOM/CORBA compatibility; a wxWindows book;
8b283bb8
JS
236<a href="http://wxworkshop.sourceforge.net/">wxWorkshop</a>, an IDE;
237other platforms, especially embedded systems; other interface abilities such as speech output.<P>
b953bdc2
JS
238
239We will investigate the possibility of compiler or operating system vendors bundling wxWindows with
240their product.<P>
241
242The high-level goal of wxWindows is to be thought of as the number one C++ framework,
243for virtually any platform. Move over, MFC!<P>
244
2b5f62a0
VZ
245<h3><a name="base">What is wxBase?</a></h3>
246
247wxBase is a subset of wxWindows comprised by the non-GUI classes. It includes
248wxWindows container and primitive data type classes (including wxString,
249wxDateTime and so on) and also useful wrappers for the operating system objects
250such as files, processes, threads, sockets and so on. With very minor
251exceptions wxBase may be used in exactly the same way as wxWindows but it
252doesn&#39;t require a GUI to run and so is ideal for creating console mode
253utilities or server programs. It is also possible to create a program which can
254be compiled either as a console application (using wxBase) or a GUI one (using
255a full featured wxWindows port).
256
8b283bb8
JS
257<H3><a name="univ">What is wxUniversal?</a></H3>
258
2b5f62a0
VZ
259The main difference between wxUniversal-based ports (such as wxX11, wxMGL) and other ports (such as wxMSW, wxGTK+, wxMac)
260is that wxUniversal implements all controls (or widgets) in
261wxWindows itself thus allowing to have much more flexibility (for example, support for
262themes even under MS Windows). It also means that it is now much easier to
8b283bb8
JS
263port wxWindows to a new platform as only the low-level classes must be ported
264which make for a small part of the library.
265<p>
266You may find more about wxUniversal <a href=wxuniv.htm>here</a>.
267
268<H3><a name="jave">What about Java?</a></H3>
b953bdc2
JS
269
270The Java honeymoon period is over :-) and people are realising that it cannot
8b283bb8 271meet all their cross-platform development needs. We don&#39;t anticipate a major threat
b953bdc2
JS
272from Java, and the level of interest in wxWindows is as high as ever.<P>
273
c2d48b36
JS
274<H3><a name="dotnet">What about .NET/Mono?</a></H3>
275
276Microsoft is spending a lot on promoting the .NET initiative, which
277is a set of languages, APIs and web service components for Windows.
278Ximian has started an open source version of .NET, mostly for Linux.
279C&#35; is Microsoft's alternative to Java, supporting 'managed code',
280garbage collection and various other Java-like language features.<P>
281
282Although this may be attractive to some developers, there
283is a variety of reasons why the .NET/Mono combination is unlikely
284to make wxWindows redundant. Please note that the following comments
285are Julian Smart's opinions.<P>
286
287<ol>
288<li>Not everyone wants or needs net services.
289<li>C++ will be used for a long time to come; compared with C++, C&#35; is a recent development and its future is not certain.
290<li>Mono Forms may only target Winelib (at least to begin with), so the end result is not as native as
291wxWindows (I'm aware there is GTK&#35; for use with the C&#35; language).
292<li>C&#35; is usually byte-compiled and therefore slower. Plus, .NET adds a layer of overhead to the client computer
293that wxWindows does not require.
294<li>Mono hasn't proven its long-term viability yet (it's a complex system of components); wxWindows is ready now.
295<li>You may not wish to buy into Microsoft marketing spin and APIs.
eb269381
JS
296<li>Microsoft may at some point sue developers of non-Microsoft .NET implementations. After all,
297platform-independence is not in Microsoft's interest.
c2d48b36
JS
298<li>.NET might never be implemented on some platforms, especially Mac and embedded variants of Linux.
299<li>wxPython and other language variants provide further reasons for wxWindows to continue.
300<li>The same issue exists for Qt: if Qt sales remain strong, it's a good indication that
301the market for a C++-based approach is still there. (Either that, or everyone's turning to wxWindows!)
302</ol>
303
304There is nothing to stop folk from developing a C&#35; version of the wxWindows API;
305we already have bindings to Python, Perl, JavaScript, Lua, Basic, and Eiffel.
306Update: a <a href="http://wxnet.sourceforge.net/" target=_new>wx.NET</a> project is now in progress.
307
308<P>
309
8b283bb8 310<H3><a name="help">How can I help the project?</a></H3>
b953bdc2 311
8b283bb8
JS
312Please check out the <a href="http://www.wxwindows.org/develop2.htm">Community</a> pages,
313in particular the <a href="projects.htm">suggested projects</a>, and
2b5f62a0 314mail the developers&#39; mailing list with your own suggestions.<P>
b953bdc2 315
ce3ed50d
JS
316</font>
317
318</BODY>
319
320</HTML>