]>
Commit | Line | Data |
---|---|---|
1 | <HTML> | |
2 | ||
3 | <HEAD> | |
4 | <TITLE>wxWidgets Documentation</TITLE> | |
5 | ||
6 | </HEAD> | |
7 | ||
8 | <BODY BGCOLOR=#FFFFFF TEXT=#000000 VLINK="#63659C" LINK="#313063" ALINK="#313063"> | |
9 | ||
10 | <font face="Arial, Lucida Sans, Helvetica"> | |
11 | ||
12 | <a name="top"></a> | |
13 | ||
14 | <IMG src="logo.gif" align=right hspace=10 vspace=0> | |
15 | ||
16 | <b>Welcome to wxWidgets, the première cross-platform GUI C++ framework.</b><P> | |
17 | ||
18 | This is an index of | |
19 | the plain text, HTML, Windows Help and Acrobat documentation: availability depends on what you've | |
20 | downloaded from the <a href="http://www.wxwidgets.org">wxWidgets Web site</a>.<br clear=all><P> | |
21 | ||
22 | <CENTER> | |
23 | <FONT size=-1> | |
24 | [<a href="#install">Install</a>] | |
25 | [<a href="#manuals">Manuals</a>] | |
26 | [<a href="#technotes">Technical Notes</a>] | |
27 | [<a href="#samples">Samples</a>] | |
28 | [<a href="#demos">Demos</a>] | |
29 | </FONT> | |
30 | </CENTER> | |
31 | ||
32 | <P> | |
33 | ||
34 | <table width=100% border=0 cellpadding=3 cellspacing=0> | |
35 | <tr> | |
36 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> | |
37 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
38 | <b><a name="install">Installation and release notes</a></b> | |
39 | </font> | |
40 | </td> | |
41 | </tr> | |
42 | </table> | |
43 | ||
44 | <P> | |
45 | ||
46 | Unless you installed a binary version of wxWidgets using RPMs, | |
47 | you will probably have to compile the wxWidgets library first. | |
48 | Please read the platform-specific readme.txt and install.txt | |
49 | for how to do this. | |
50 | ||
51 | <P> | |
52 | ||
53 | <ul> | |
54 | <li>ReadMe: <a href="../readme.txt"><b>General ReadMe</b></a>, | |
55 | <a href="../msw/readme.txt">wxMSW</a>, | |
56 | <a href="../gtk/readme.txt">wxGTK</a>, | |
57 | <a href="../mac/readme.txt">wxMac</a>, | |
58 | <a href="../cocoa/readme.txt">wxCocoa</a>, | |
59 | <a href="../mgl/readme.txt">wxMGL</a>, | |
60 | <a href="../motif/readme.txt">wxMotif</a>, | |
61 | <a href="../x11/readme.txt">wxX11</a>, | |
62 | <a href="../univ/readme.txt">Univ</a> | |
63 | <li>Installation: | |
64 | <a href="../msw/install.txt">wxMSW</a>, | |
65 | <a href="../gtk/install.txt">wxGTK</a>, | |
66 | <a href="../motif/install.txt">wxMotif</a>, | |
67 | <a href="../x11/install.txt">wxX11</a>, | |
68 | <a href="../mac/install.txt">wxMac</a>, | |
69 | <a href="../cocoa/install.txt">wxCocoa</a>, | |
70 | <a href="../mgl/install.txt">wxMGL</a>, | |
71 | <a href="../os2/install.txt">wxOS2</a> | |
72 | <li><a href="../changes.txt"><b>General change log</b></a> | |
73 | <li>Licence: <a href="../preamble.txt">Preamble</a>, | |
74 | <a href="../licence.txt">Licence</a>, | |
75 | <a href="../licendoc.txt">Documentation Licence</a>, | |
76 | <a href="../lgpl.txt">L-GPL</a>, | |
77 | <a href="../gpl.txt">GPL</a> | |
78 | <li><a href="faq.htm"><B>FAQ</B></a>: | |
79 | <ul> | |
80 | <li><a href="faqgen.htm">General questions</a> | |
81 | <li><a href="faqcmn.htm">Questions common to all platforms</a> | |
82 | <li><a href="faqmsw.htm">wxWidgets for Windows</a> | |
83 | <li><a href="faqgtk.htm">wxWidgets for GTK+</a> | |
84 | <li><a href="faqmot.htm">wxWidgets for Motif</a> | |
85 | <li><a href="faqx11.htm">wxWidgets for X11</a> | |
86 | <li><a href="faqmac.htm">wxWidgets for Mac</a> | |
87 | </ul> | |
88 | <li>ToDo: <a href="../todo.txt"><b>General ToDo</b></a>, | |
89 | <a href="../gtk/todo.txt">wxGTK</a>, | |
90 | <a href="../motif/todo.txt">wxMotif</a>, | |
91 | <a href="../mac/todo.txt">wxMac</a> | |
92 | </ul> | |
93 | ||
94 | Further platform-specific notes: | |
95 | ||
96 | <ul> | |
97 | <li> wxMSW: <a href="../msw/winxp.txt">Windows XP</a> | |
98 | </ul> | |
99 | ||
100 | <P> | |
101 | ||
102 | <table width=100% border=0 cellpadding=3 cellspacing=0> | |
103 | <tr> | |
104 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> | |
105 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
106 | <b><a name="manuals">wxWidgets manuals</a></b> | |
107 | </font> | |
108 | </td> | |
109 | </tr> | |
110 | </table> | |
111 | ||
112 | <P> | |
113 | ||
114 | To use manuals in wxHTML Help form (extension htb), you can use the <b>HelpView</b> | |
115 | application, either compiling it from utils/helpview in the distribution, | |
116 | or downloading a binary, for example from <a href="http://www.storylinescentral.com/helpview.htm">here</a>.<P> | |
117 | ||
118 | <table border=0 cellpadding=5 cellspacing=0> | |
119 | ||
120 | <tr> | |
121 | <td align=center bgcolor="#E0E0E0"> | |
122 | <B>HTML</B> | |
123 | </td> | |
124 | <td align=center bgcolor="#E0E0E0"> | |
125 | <B>WinHelp</B> | |
126 | </td> | |
127 | <td align=center bgcolor="#E0E0E0"> | |
128 | <B>MS HTML Help</B> | |
129 | </td> | |
130 | <td align=center bgcolor="#E0E0E0"> | |
131 | <B>wxHTML Help</B> | |
132 | </td> | |
133 | <td align=center bgcolor="#E0E0E0"> | |
134 | <B>PDF</B> | |
135 | </td> | |
136 | </tr> | |
137 | ||
138 | <tr> | |
139 | <td align=center> | |
140 | <a href="wx/wx_contents.html">wxWidgets Reference</a> | |
141 | </td> | |
142 | ||
143 | <td align=center> | |
144 | <a href="../winhelp/wx.hlp">wxWidgets Reference</a> | |
145 | </td> | |
146 | ||
147 | <td align=center> | |
148 | <a href="../htmlhelp/wx.chm">wxWidgets Reference</a> | |
149 | </td> | |
150 | ||
151 | <td align=center> | |
152 | <a href="../htb/wx.htb">wxWidgets Reference</a> | |
153 | </td> | |
154 | ||
155 | <td align=center> | |
156 | <a href="../pdf/wx.pdf">wxWidgets Reference</a> | |
157 | </td> | |
158 | </tr> | |
159 | ||
160 | <tr> | |
161 | <td align=center> | |
162 | <a href="tex2rtf/t2rtf.htm">Tex2RTF</a> | |
163 | </td> | |
164 | ||
165 | <td align=center> | |
166 | <a href="../winhelp/tex2rtf.hlp">Tex2RTF</a> | |
167 | </td> | |
168 | ||
169 | <td align=center> | |
170 | <a href="../htmlhelp/tex2rtf.chm">Tex2RTF</a> | |
171 | </td> | |
172 | ||
173 | <td align=center> | |
174 | <a href="../htb/tex2rtf.htb">Tex2RTF</a> | |
175 | </td> | |
176 | ||
177 | <td align=center> | |
178 | <a href="../pdf/tex2rtf.pdf">Tex2RTF</a> | |
179 | </td> | |
180 | </tr> | |
181 | ||
182 | </table> | |
183 | ||
184 | <P> | |
185 | ||
186 | <table width=100% border=0 cellpadding=3 cellspacing=0> | |
187 | <tr> | |
188 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> | |
189 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
190 | <b><a name="technotes">Technical notes</a></b> | |
191 | </font> | |
192 | </td> | |
193 | </tr> | |
194 | </table> | |
195 | ||
196 | <P> | |
197 | ||
198 | <ul> | |
199 | <li><a href="../tech/index.txt">Index of technical notes</a> | |
200 | <li><a href="../tech/">Technical notes</a> | |
201 | <li><a href="platform.htm">Platforms supported</a> | |
202 | <li><a href="i18n.htm">Languages supported by wxWidgets</a> | |
203 | </ul> | |
204 | ||
205 | <P> | |
206 | ||
207 | <table width=100% border=0 cellpadding=3 cellspacing=0> | |
208 | <tr> | |
209 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> | |
210 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
211 | <b><a name="samples">Samples</a></b> | |
212 | </font> | |
213 | </td> | |
214 | </tr> | |
215 | </table> | |
216 | ||
217 | <P> | |
218 | ||
219 | Each of the following samples demonstrates one or more aspect of wxWidgets.<P> | |
220 | ||
221 | <ul> | |
222 | <li><a href="../../samples/access">access</a>: Active Accessiblity sample (Windows only). | |
223 | <li><a href="../../samples/animate">animate</a>: shows the wxAnimationCtrl class. | |
224 | <li><a href="../../samples/artprov">artprov</a>: shows how you can customize the look of standard | |
225 | wxWidgets dialogs by replacing default bitmaps/icons with your own versions. | |
226 | <li><a href="../../samples/aui">aui</a>: wxAui (docking subsystem) sample. | |
227 | <li><a href="../../samples/calendar">calendar</a>: a sample to test the wxCalendarCtrl class. | |
228 | <li><a href="../../samples/caret">caret</a>: a sample to test the wxCaret class. | |
229 | <li><a href="../../samples/checklst">checklst</a>: demonstrates wxCheckListBox on | |
230 | supported platforms (currently Windows and GTK only). | |
231 | <li><a href="../../samples/collpane">collpane</a>: shows the wxCollapsiblePane class. | |
232 | <li><a href="../../samples/config">config</a>: demonstrates use of wxConfig, which | |
233 | defaults to wxRegConfig on WIN32 (optionally wxIniConfig), and wxFileConfig on other platforms. | |
234 | <li><a href="../../samples/console">console</a>: demonstrates a console application using | |
235 | console-mode (no-GUI) compilation of wxWidgets. | |
236 | <li><a href="../../samples/controls">controls</a>: sample showing a variety of controls, including | |
237 | wxNotebook. | |
238 | <li><a href="../../samples/db">db</a>: wxODBC sample. | |
239 | <li><a href="../../samples/debugrpt">debugrpt</a>: wxDebugReport sample. | |
240 | <li><a href="../../samples/dialogs">dialogs</a>: shows some of the common dialogs available -- wxFontDialog, | |
241 | wxColourDialog, wxFileDialog, wxDirDialog, wxMessageBox, wxTextEntryDialog, wxSingleChoiceDialog. | |
242 | For printing-related dialogs, see the printing sample. | |
243 | <li><a href="../../samples/dialup">dialup</a>: wxDialUpManager demo. | |
244 | <li><a href="../../samples/display">display</a>: wxDisplay demo. | |
245 | <li><a href="../../samples/dnd">dnd</a>: demonstrates drag and drop on supported platforms. | |
246 | <li><a href="../../samples/docview">docview</a>: demonstrates use of the document view classes, | |
247 | using wxFrame. | |
248 | <li><a href="../../samples/docvwmdi">docvwmdi</a>: demonstrates use of the document view classes, | |
249 | using wxMDIParentFrame, wxMDIChildFrame. | |
250 | <li><a href="../../samples/dragimag">dragimag</a>: wxDragImage demo. | |
251 | <li><a href="../../samples/drawing">drawing</a>: tests device context drawing. | |
252 | <li><a href="../../samples/dynamic">dynamic</a>: shows how to connect events to member functions | |
253 | dynamically. | |
254 | <li><a href="../../samples/editlbox">erase</a>: shows the wxEditableListBox class. | |
255 | <li><a href="../../samples/erase">erase</a>: Window erasing sample. | |
256 | <li><a href="../../samples/event">event</a>: demonstrates event handling. | |
257 | <li><a href="../../samples/except">exept</a>: demonstrates exception handling. | |
258 | <li><a href="../../samples/exec">exec</a>: demonstrates wxExecute. | |
259 | <li><a href="../../samples/font">font</a>: tests fonts, font enumerator, font encodings. | |
260 | <li><a href="../../samples/grid">grid</a>: demonstrates the wxGrid class. | |
261 | <li><a href="../../samples/help">help</a>: shows how to use wxHelpController. | |
262 | <li><a href="../../samples/html">html</a>: a number of demos for the wxHTML class library, used inside | |
263 | applications and also as a help facility. | |
264 | <ul> | |
265 | <li><a href="../../samples/html/about">about</a>: shows use of a wxHTML widget inside an About box. | |
266 | <li><a href="../../samples/html/help">help</a>: shows use of wxHtmlHelpController to display wxHTML help. | |
267 | <li><a href="../../samples/html/helpview">helpview</a>: a stand-alone wxHTML help viewer for any .htb book. | |
268 | <li><a href="../../samples/html/printing">printing</a>: shows how easy it is to preview and print HTML files. | |
269 | <li><a href="../../samples/html/test">test</a>: general wxHTML test application. | |
270 | <li><a href="../../samples/html/virtual">virtual</a>: demonstrates the virtual file system feature. | |
271 | <li><a href="../../samples/html/widget">widget</a>: demonstrates the use of controls in HTML pages. | |
272 | <li><a href="../../samples/html/zip">zip</a>: shows how help files can be packaged in zip archives. | |
273 | </ul> | |
274 | <li><a href="../../samples/htlbox">htlbox</a>: demonstrates wxHtmlListBox. | |
275 | <li><a href="../../samples/image">image</a>: shows off the cross-platform wxImage class. | |
276 | <li><a href="../../samples/ipc">ipc</a>: shows the DDE-like protocol in action, both using real | |
277 | DDE on Windows, and TCP/IP on all platforms. Edit <a href="../../samples/ipc/ddesetup.h">ddesetup.h</a> | |
278 | to switch between compilation modes. | |
279 | <li><a href="../../samples/internat">internat</a>: use of wxWidgets' internationalization support. | |
280 | <li><a href="../../samples/joytest">joytest</a>: tests the wxJoystick class (currently Windows and GTK only). | |
281 | <li><a href="../../samples/keyboard">keyboard</a>: tests keyboard support. | |
282 | <li><a href="../../samples/layout">layout</a>: shows the constraint layout system in action. | |
283 | <li><a href="../../samples/listctrl">listctrl</a>: demonstrates the wxListCtrl (implemented natively on | |
284 | WIN32, and using a generic version on other platforms). | |
285 | <li><a href="../../samples/menu">menu</a>: tests menus. | |
286 | <li><a href="../../samples/mediaplayer">mediaplayer</a>: demonstrates wxMediaCtrl, for playing movies and audio files in a window. | |
287 | <li><a href="../../samples/mdi">mdi</a>: shows off the MDI (Multiple Document Interface) classes. On Windows, the regular MDI | |
288 | scheme is used whereby child windows have full sizing and moving rights within the main | |
289 | window. On other platforms, tabbed windows are used, where the children are always maximized. | |
290 | <li><a href="../../samples/memcheck">memcheck</a>: demonstrates the memory checking/debugging facilities. | |
291 | <li><a href="../../samples/mfc">mfc</a>: shows how to use MFC and wxWidgets code in the same application (Windows only). | |
292 | To compile this, you must edit include/wx/wxprec.h, comment out the windows.h inclusion, and recompile wxWidgets. | |
293 | <li><a href="../../samples/minifram">minifram</a>: demonstrates a frame with a small title bar. On | |
294 | platforms that don't support it, a normal-sized title bar is displayed. | |
295 | <li><a href="../../samples/minimal">minimal</a>: just shows a frame, a menubar, and a statusbar. About as | |
296 | small a wxWidgets application as you can get. | |
297 | <li><a href="../../samples/mobile">mobile</a>: mini applications for embedded platforms. | |
298 | <li><a href="../../samples/multimon">multimon</a>: demo showing how to use multiple monitors. | |
299 | <li><a href="../../samples/nativdlg">nativdlg</a>: shows how wxWidgets can load a standard Windows | |
300 | dialog resource, translating the controls into wxWidgets controls (Windows only). | |
301 | <li><a href="../../samples/notebook">notebook</a>: shows the wxNotebook (tabbed window) control. | |
302 | <li><a href="../../samples/oleauto">oleauto</a>: a little OLE automation controller (Windows only; requires | |
303 | Excel to be present). | |
304 | <li><a href="../../samples/ownerdrw">ownerdrw</a>: demonstrates owner-draw menus and controls (Windows only). | |
305 | <li><a href="../../samples/png">png</a>: demonstrates PNG loading. | |
306 | <li><a href="../../samples/printing">printing</a>: shows printing and previewing. | |
307 | <li><a href="../../samples/propsize">propsize</a>: demonstrates proportional sizer classes. | |
308 | <li><a href="../../samples/regtest">regtest</a>: tests the low-level Windows registry functions (Windows only). | |
309 | <li><a href="../../samples/render">render</a>: shows how to use wxRenderer to implement controls consistent with the | |
310 | platform's native look. | |
311 | <li><a href="../../samples/richtext">richtext</a>: demonstrates wxRichTextCtrl. | |
312 | <li><a href="../../samples/rotate">rotate</a>: demonstrates interpolated and non-interpolated | |
313 | rotation of a wxImage. | |
314 | <li><a href="../../samples/sashtest">sashtest</a>: demonstrates use of the wxSashWindow class to allow | |
315 | the user to resize subwindows. | |
316 | <li><a href="../../samples/scroll">scroll</a>: demonstrates wxScrolledWindow. | |
317 | <li><a href="../../samples/scrollsub">scrollsub</a>: demonstrates the use of wxScrolledWindow to scroll | |
318 | an embedded window. | |
319 | <li><a href="../../samples/shaped">shaped</a>: demonstrates non-rectangular windows using wxFrame::SetShape. | |
320 | <li><a href="../../samples/sockets">sockets</a>: demonstrates the TCP/IP family of classes. | |
321 | <li><a href="../../samples/sound">sound</a>: demonstrates use of wxSound. | |
322 | <li><a href="../../samples/splash">splash</a>: demonstrates use of the wxSplashScreen class. | |
323 | <li><a href="../../samples/splitter">splitter</a>: demonstrates the wxSplitterWindow class. | |
324 | <li><a href="../../samples/statbar">statbar</a>: demonstrates the wxStatusBar class. | |
325 | <li><a href="../../samples/taskbar">taskbar</a>: demonstrates the wxTaskBarIcon class, for | |
326 | adding icons to the system tray. Windows only, but may eventually be implemented for other desktop | |
327 | environments that use this metaphor. | |
328 | <li><a href="../../samples/text">text</a>: demonstrates single and multiline text controls, | |
329 | and clipboard operations. | |
330 | <li><a href="../../samples/thread">thread</a>: tests the family of classes for doing thread | |
331 | programming. | |
332 | <li><a href="../../samples/toolbar">toolbar</a>: demonstrates wxToolBar. | |
333 | <li><a href="../../samples/treectrl">treectrl</a>: demonstrates wxTreeCtrl. | |
334 | <li><a href="../../samples/typetest">typetest</a>: tests various data type classes, including | |
335 | wxTime, wxDate and wxVariant. | |
336 | <li><a href="../../samples/validate">validate</a>: shows simple use of validation. | |
337 | <li><a href="../../samples/vscroll">vscroll</a>: shows use of wxVScrolledWindow. | |
338 | <li><a href="../../samples/widgets">widgets</a>: shows a lot of control classes. | |
339 | <li><a href="../../samples/wizard">wizard</a>: demonstrates the wxWizard class. | |
340 | <li><a href="../../samples/xrc">xrc</a>: demonstrates the XRC resource system. | |
341 | </ul> | |
342 | ||
343 | ||
344 | <P> | |
345 | ||
346 | <table width=100% border=0 cellpadding=3 cellspacing=0> | |
347 | <tr> | |
348 | <td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif"> | |
349 | <font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF"> | |
350 | <b><a name="demos">Demos</a></b> | |
351 | </font> | |
352 | </td> | |
353 | </tr> | |
354 | </table> | |
355 | ||
356 | <P> | |
357 | ||
358 | The following are fully-fledged applications.<P> | |
359 | ||
360 | <ul> | |
361 | <li><a href="../../demos/bombs">bombs</a>: minesweeper-like game. | |
362 | <li><a href="../../demos/dbbrowse">dbbrowse</a>: ODBC database browser application. | |
363 | <li><a href="../../demos/forty">forty</a>: a great little card game by Chris Breeze. | |
364 | <li><a href="../../demos/fractal">fractal</a>: fractal mountains by Andrew Davison. | |
365 | <li><a href="../../demos/life">life</a>: the game of Life by J. H. Conway, implemented in wxWidgets by Guillermo Rodriguez Garcia. | |
366 | <li><a href="../../demos/poem">poem</a>: a little poetry display program. | |
367 | </ul> | |
368 | ||
369 | </font> | |
370 | ||
371 | </BODY> | |
372 | ||
373 | </HTML> | |
374 |