<HTML>
<HEAD>
-<TITLE>wxWindows Documentation</TITLE>
+<TITLE>wxWidgets Documentation</TITLE>
</HEAD>
-<BODY BGCOLOR="#FFFFFF" TEXT=#000000 LINK=#FF0000 VLINK=#000000>
+<BODY BGCOLOR=#FFFFFF TEXT=#000000 VLINK="#63659C" LINK="#313063" ALINK="#313063">
<font face="Arial, Lucida Sans, Helvetica">
<a name="top"></a>
-<table width=100% border=4 cellpadding=5 cellspacing=0>
+<IMG src="logo.gif" align=right hspace=10 vspace=0>
+
+<b>Welcome to wxWidgets, the première cross-platform GUI C++ framework.</b><P>
+
+This is an index of
+the plain text, HTML, Windows Help and Acrobat documentation: availability depends on what you've
+downloaded from the <a href="http://www.wxwidgets.org">wxWidgets Web site</a>.<br clear=all><P>
+
+<CENTER>
+<FONT size=-1>
+[<a href="#install">Install</a>]
+[<a href="#manuals">Manuals</a>]
+[<a href="#technotes">Technical Notes</a>]
+[<a href="#thirdparty">3rd party tools</a>]
+[<a href="#contribs">Optional Libraries</a>]
+[<a href="#samples">Samples</a>]
+[<a href="#demos">Demos</a>]
+</FONT>
+</CENTER>
+
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
<tr>
-<td bgcolor="#660000">
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
-<IMG src="logo.gif" align=right>
-<!-- wxWindows Documentation -->
+<b><a name="install">Installation and release notes</a></b>
</font>
</td>
</tr>
<P>
-Welcome to wxWindows 2.0, the premiere cross-platform C++ framework. This is an index of
-the plain text and HTML documentation. Documentation is also available in Acrobat (PDF) and Windows Help,
-from the <a href="http://wxwin.home.ml.org">wxWindows Web site</a>.<P>
+Unless you installed a binary version of wxWidgets using RPMs,
+you will probably have to compile the wxWidgets library first.
+Please read the platform-specific readme.txt and install.txt
+for how to do this.
-<h3>Installation and release notes</h3>
+<P>
<ul>
+<li>ReadMe: <a href="../readme.txt"><b>General ReadMe</b></a>,
+<a href="../msw/readme.txt">wxMSW</a>,
+<a href="../gtk/readme.txt">wxGTK</a>,
+<a href="../mac/readme.txt">wxMac</a>,
+<a href="../cocoa/readme.txt">wxCocoa</a>,
+<a href="../mgl/readme.txt">wxMGL</a>,
+<a href="../motif/readme.txt">wxMotif</a>,
+<a href="../x11/readme.txt">wxX11</a>,
+<a href="../univ/readme.txt">Univ</a>
+<li>Installation:
+<a href="../msw/install.txt">wxMSW</a>,
+<a href="../gtk/install.txt">wxGTK</a>,
+<a href="../motif/install.txt">wxMotif</a>,
+<a href="../x11/install.txt">wxX11</a>,
+<a href="../mac/install.txt">wxMac</a>,
+<a href="../cocoa/install.txt">wxCocoa</a>,
+<a href="../mgl/install.txt">wxMGL</a>,
+<a href="../os2/install.txt">wxOS2</a>
+<li><a href="../changes.txt"><b>General change log</b></a>
<li>Licence: <a href="../preamble.txt">Preamble</a>,
<a href="../licence.txt">Licence</a>,
<a href="../licendoc.txt">Documentation Licence</a>,
<a href="../lgpl.txt">L-GPL</a>,
<a href="../gpl.txt">GPL</a>
-<li>ReadMe: <a href="../gtk/readme.txt">wxGTK</a>,
-<a href="../motif/readme.txt">wxMotif</a>,
-<a href="../msw/readme.txt">wxMSW</a>
-<li>Installation: <a href="../gtk/install.txt">wxGTK</a>,
-<a href="../motif/install.txt">wxMotif</a>,
-<a href="../msw/install.txt">wxMSW</a>
-<li>Change logs: <a href="../motif/changes.txt">wxMotif</a>,
-<a href="../msw/changes.txt">wxMSW</a>
-<li>ToDo: <a href="../gtk/todo.txt">wxGTK</a>,
+<li><a href="faq.htm"><B>FAQ</B></a>:
+ <ul>
+ <li><a href="faqgen.htm">General questions</a>
+ <li><a href="faqcmn.htm">Questions common to all platforms</a>
+ <li><a href="faqmsw.htm">wxWidgets for Windows</a>
+ <li><a href="faqgtk.htm">wxWidgets for GTK+</a>
+ <li><a href="faqmot.htm">wxWidgets for Motif</a>
+ <li><a href="faqx11.htm">wxWidgets for X11</a>
+ <li><a href="faqunx.htm">wxWidgets for Unix</a>
+ <li><a href="faqmac.htm">wxWidgets for Mac</a>
+ </ul>
+<li>ToDo: <a href="../todo.txt"><b>General ToDo</b></a>,
+<a href="../gtk/todo.txt">wxGTK</a>,
<a href="../motif/todo.txt">wxMotif</a>,
-<a href="../msw/todo.txt">wxMSW</a>
-<li>List of <a href="../symbols.txt">preprocessor symbols</a> used in wxWindows
+<a href="../mac/todo.txt">wxMac</a>
+</ul>
+
+Further platform-specific notes:
+
+<ul>
+<li> wxMSW: <a href="../msw/winxp.txt">Windows XP</a>
+</ul>
+
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="manuals">wxWidgets manuals</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+To use manuals in wxHTML Help form (extension htb), you can use the <b>HelpView</b>
+application, either compiling it from utils/helpview in the distribution,
+or downloading a binary, for example from <a href="http://www.storylinescentral.com/helpview.htm">here</a>.<P>
+
+<table border=0 cellpadding=5 cellspacing=0>
+
+<tr>
+<td align=center bgcolor="#E0E0E0">
+<B>HTML</B>
+</td>
+<td align=center bgcolor="#E0E0E0">
+<B>WinHelp</B>
+</td>
+<td align=center bgcolor="#E0E0E0">
+<B>MS HTML Help</B>
+</td>
+<td align=center bgcolor="#E0E0E0">
+<B>wxHTML Help</B>
+</td>
+<td align=center bgcolor="#E0E0E0">
+<B>PDF</B>
+</td>
+</tr>
+
+<tr>
+<td align=center>
+<a href="wx/wx_contents.html">wxWidgets Reference</a>
+</td>
+
+<td align=center>
+<a href="../winhelp/wx.hlp">wxWidgets Reference</a>
+</td>
+
+<td align=center>
+<a href="../htmlhelp/wx.chm">wxWidgets Reference</a>
+</td>
+
+<td align=center>
+<a href="../htb/wx.htb">wxWidgets Reference</a>
+</td>
+
+<td align=center>
+<a href="../pdf/wx.pdf">wxWidgets Reference</a>
+</td>
+</tr>
+
+<tr>
+<td align=center>
+<a href="tex2rtf/t2rtf.htm">Tex2RTF</a>
+</td>
+
+<td align=center>
+<a href="../winhelp/tex2rtf.hlp">Tex2RTF</a>
+</td>
+
+<td align=center>
+<a href="../htmlhelp/tex2rtf.chm">Tex2RTF</a>
+</td>
+
+<td align=center>
+<a href="../htb/tex2rtf.htb">Tex2RTF</a>
+</td>
+
+<td align=center>
+<a href="../pdf/tex2rtf.pdf">Tex2RTF</a>
+</td>
+</tr>
+
+<tr>
+<td align=center>
+<a href="fl/fl.htm">FL Library</a>
+</td>
+
+<td align=center>
+<a href="../winhelp/fl.hlp">FL Library</a>
+
+</td>
+
+<td align=center>
+<a href="../htmlhelp/fl.chm">FL Library</a>
+</td>
+
+<td align=center>
+<a href="../htb/fl.htb">FL Library</a>
+</td>
+
+<td align=center>
+<a href="../pdf/fl.pdf">FL Library</a>
+</td>
+</tr>
+
+<tr>
+<td align=center>
+<a href="ogl/ogl.htm">OGL Library</a>
+</td>
+
+<td align=center>
+<a href="../winhelp/ogl.hlp">OGL Library</a>
+
+</td>
+
+<td align=center>
+<a href="../htmlhelp/ogl.chm">OGL Library</a>
+</td>
+
+<td align=center>
+<a href="../htb/ogl.htb">OGL Library</a>
+</td>
+
+<td align=center>
+<a href="../pdf/ogl.pdf">OGL Library</a>
+</td>
+</tr>
+
+</table>
+
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="technotes">Technical notes</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+<ul>
+<li><a href="../tech/index.txt">Index of technical notes</a>
+<li><a href="../tech/">Technical notes</a>
+<li><a href="platform.htm">Platforms supported</a>
+<li><a href="i18n.htm">Languages supported by wxWidgets</a>
</ul>
-<h3>wxWindows manuals</h3>
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="thirdparty">Thirty-party tools</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
<ul>
-<li><a href="wx/wx.htm">Reference Manual</a>
-<li><a href="porting/port.htm">Porting Guide</a> (wxWindows 1.xx to 2.0)
-<li><a href="dialoged/dlged.htm">Dialog Editor</a>
-<li><a href="wxprop/prop.htm">Property Classes</a>
-<li><a href="wxtree/tree.htm">wxTreeLayout</a>
-<li><a href="odbc/odbc.htm">Remstar ODBC Classes</a>
+<li><a href="gettext/index.html">gettext Manual</a>
</ul>
-<h3>Third-party tools</h3>
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="contribs">Optional Libraries</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+These are the optional libraries in the <a href="../../contrib">contrib</a> hierarchy.<P>
+
+<ul>
+<li><a href="../../contrib/src/animate">animate</a>: a flip-book animation class, with animated GIF player.
+<li><a href="../../contrib/src/deprecated">deprecated</a>: deprecated classes including the old WXR resource system and property sheet classes.
+<li><a href="../../contrib/src/fl">fl</a>: a frame layout/docking library.
+<li><a href="../../contrib/src/foldbar">foldbar</a>: wxFoldPanel class for economical layout of controls.
+<li><a href="../../contrib/src/gizmos">gizmos</a>: a variety of GUI classes including wxDynamicSashWindow, wxLEDNumberCtrl, wxEditableListBox, wxStaticPicture
+and a split tree/content view.
+<li><a href="../../contrib/src/mmedia">mmedia</a>: deprecated library for playing audio and video.
+<li><a href="../../contrib/src/net">net</a>: wxEmail class.
+<li><a href="../../contrib/src/ogl">ogl</a>: Object Graphics Library (for drawing connected shapes).
+<li><a href="../../contrib/src/plot">plot</a>: simple plotting class.
+<li><a href="../../contrib/src/stc">stc</a>: wxStyledTextControl, a wrapper for the Scintilla code editor control.
+<li><a href="../../contrib/src/svg">svg</a>: wxSVGFileDC class for drawing vector graphics into a SVG file.
+</ul>
+
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="samples">Samples</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+Each of the following samples demonstrates one or more aspect of wxWidgets.<P>
+
+<ul>
+<li><a href="../../samples/access">access</a>: Active Accessiblity sample (Windows only).
+<li><a href="../../samples/artprov">artprov</a>: shows how you can customize the look of standard
+wxWidgets dialogs by replacing default bitmaps/icons with your own versions.
+<li><a href="../../samples/calendar">calendar</a>: a sample to test the wxCalendarCtrl class.
+<li><a href="../../samples/caret">caret</a>: a sample to test the wxCaret class.
+<li><a href="../../samples/checklst">checklst</a>: demonstrates wxCheckListBox on
+supported platforms (currently Windows and GTK only).
+<li><a href="../../samples/config">config</a>: demonstrates use of wxConfig, which
+defaults to wxRegConfig on WIN32 (optionally wxIniConfig), and wxFileConfig on other platforms.
+<li><a href="../../samples/console">console</a>: demonstrates a console application using
+console-mode (no-GUI) compilation of wxWidgets.
+<li><a href="../../samples/controls">controls</a>: sample showing a variety of controls, including
+wxNotebook.
+<li><a href="../../samples/db">db</a>: wxODBC sample.
+<li><a href="../../samples/debugrpt">debugrpt</a>: wxDebugReport sample.
+<li><a href="../../samples/dialogs">dialogs</a>: shows some of the common dialogs available -- wxFontDialog,
+wxColourDialog, wxFileDialog, wxDirDialog, wxMessageBox, wxTextEntryDialog, wxSingleChoiceDialog.
+For printing-related dialogs, see the printing sample.
+<li><a href="../../samples/dialup">dialup</a>: wxDialUpManager demo.
+<li><a href="../../samples/display">display</a>: wxDisplay demo.
+<li><a href="../../samples/dnd">dnd</a>: demonstrates drag and drop on supported platforms.
+<li><a href="../../samples/docview">docview</a>: demonstrates use of the document view classes,
+using wxFrame.
+<li><a href="../../samples/docvwmdi">docvwmdi</a>: demonstrates use of the document view classes,
+using wxMDIParentFrame, wxMDIChildFrame.
+<li><a href="../../samples/dragimag">dragimag</a>: wxDragImage demo.
+<li><a href="../../samples/drawing">drawing</a>: tests device context drawing.
+<li><a href="../../samples/dynamic">dynamic</a>: shows how to connect events to member functions
+dynamically.
+<li><a href="../../samples/erase">erase</a>: Window erasing sample.
+<li><a href="../../samples/event">event</a>: demonstrates event handling.
+<li><a href="../../samples/except">exept</a>: demonstrates exception handling.
+<li><a href="../../samples/exec">exec</a>: demonstrates wxExecute.
+<li><a href="../../samples/font">font</a>: tests fonts, font enumerator, font encodings.
+<li><a href="../../samples/grid">grid</a>: demonstrates the wxGrid class.
+<li><a href="../../samples/help">help</a>: shows how to use wxHelpController.
+<li><a href="../../samples/html">html</a>: a number of demos for the wxHTML class library, used inside
+applications and also as a help facility.
+ <ul>
+ <li><a href="../../samples/html/about">about</a>: shows use of a wxHTML widget inside an About box.
+ <li><a href="../../samples/html/help">help</a>: shows use of wxHtmlHelpController to display wxHTML help.
+ <li><a href="../../samples/html/helpview">helpview</a>: a stand-alone wxHTML help viewer for any .htb book.
+ <li><a href="../../samples/html/printing">printing</a>: shows how easy it is to preview and print HTML files.
+ <li><a href="../../samples/html/test">test</a>: general wxHTML test application.
+ <li><a href="../../samples/html/virtual">virtual</a>: demonstrates the virtual file system feature.
+ <li><a href="../../samples/html/widget">widget</a>: demonstrates the use of controls in HTML pages.
+ <li><a href="../../samples/html/zip">zip</a>: shows how help files can be packaged in zip archives.
+ </ul>
+<li><a href="../../samples/htlbox">htlbox</a>: demonstrates wxHtmlListBox.
+<li><a href="../../samples/image">image</a>: shows off the cross-platform wxImage class.
+<li><a href="../../samples/ipc">ipc</a>: shows the DDE-like protocol in action, both using real
+DDE on Windows, and TCP/IP on all platforms. Edit <a href="../../samples/ipc/ddesetup.h">ddesetup.h</a>
+to switch between compilation modes.
+<li><a href="../../samples/internat">internat</a>: use of wxWidgets' internationalization support.
+<li><a href="../../samples/joytest">joytest</a>: tests the wxJoystick class (currently Windows and GTK only).
+<li><a href="../../samples/keyboard">keyboard</a>: tests keyboard support.
+<li><a href="../../samples/layout">layout</a>: shows the constraint layout system in action.
+<li><a href="../../samples/listctrl">listctrl</a>: demonstrates the wxListCtrl (implemented natively on
+WIN32, and using a generic version on other platforms).
+<li><a href="../../samples/menu">menu</a>: tests menus.
+<li><a href="../../samples/mediaplayer">mediaplayer</a>: demonstrates wxMediaCtrl, for playing movies and audio files in a window.
+<li><a href="../../samples/mdi">mdi</a>: shows off the MDI (Multiple Document Interface) classes. On Windows, the regular MDI
+scheme is used whereby child windows have full sizing and moving rights within the main
+window. On other platforms, tabbed windows are used, where the children are always maximized.
+<li><a href="../../samples/memcheck">memcheck</a>: demonstrates the memory checking/debugging facilities.
+<li><a href="../../samples/mfc">mfc</a>: shows how to use MFC and wxWidgets code in the same application (Windows only).
+To compile this, you must edit include/wx/wxprec.h, comment out the windows.h inclusion, and recompile wxWidgets.
+<li><a href="../../samples/minifram">minifram</a>: demonstrates a frame with a small title bar. On
+platforms that don't support it, a normal-sized title bar is displayed.
+<li><a href="../../samples/minimal">minimal</a>: just shows a frame, a menubar, and a statusbar. About as
+small a wxWidgets application as you can get.
+<li><a href="../../samples/mobile">mobile</a>: mini applications for embedded platforms.
+<li><a href="../../samples/multimon">multimon</a>: demo showing how to use multiple monitors.
+<li><a href="../../samples/nativdlg">nativdlg</a>: shows how wxWidgets can load a standard Windows
+dialog resource, translating the controls into wxWidgets controls (Windows only).
+<li><a href="../../samples/notebook">notebook</a>: shows the wxNotebook (tabbed window) control.
+<li><a href="../../samples/oleauto">oleauto</a>: a little OLE automation controller (Windows only; requires
+Excel to be present).
+<li><a href="../../samples/ownerdrw">ownerdrw</a>: demonstrates owner-draw menus and controls (Windows only).
+<li><a href="../../samples/png">png</a>: demonstrates PNG loading.
+<li><a href="../../samples/printing">printing</a>: shows printing and previewing.
+<li><a href="../../samples/propsize">propsize</a>: demonstrates proportional sizer classes.
+<li><a href="../../samples/regtest">regtest</a>: tests the low-level Windows registry functions (Windows only).
+<li><a href="../../samples/render">render</a>: shows how to use wxRenderer to implement controls consistent with the
+platform's native look.
+<li><a href="../../samples/richedit">richedit</a>: a work-in-progress rich text editor with plain text and HTML export
+facilities.
+<li><a href="../../samples/rotate">rotate</a>: demonstrates interpolated and non-interpolated
+rotation of a wxImage.
+<li><a href="../../samples/sashtest">sashtest</a>: demonstrates use of the wxSashWindow class to allow
+the user to resize subwindows.
+<li><a href="../../samples/scroll">scroll</a>: demonstrates wxScrolledWindow.
+<li><a href="../../samples/scrollsub">scrollsub</a>: demonstrates the use of wxScrolledWindow to scroll
+an embedded window.
+<li><a href="../../samples/shaped">shaped</a>: demonstrates non-rectangular windows using wxFrame::SetShape.
+<li><a href="../../samples/sockets">sockets</a>: demonstrates the TCP/IP family of classes.
+<li><a href="../../samples/sound">sound</a>: demonstrates use of wxSound.
+<li><a href="../../samples/splash">splash</a>: demonstrates use of the wxSplashScreen class.
+<li><a href="../../samples/splitter">splitter</a>: demonstrates the wxSplitterWindow class.
+<li><a href="../../samples/statbar">statbar</a>: demonstrates the wxStatusBar class.
+<li><a href="../../samples/taskbar">taskbar</a>: demonstrates the wxTaskBarIcon class, for
+adding icons to the system tray. Windows only, but may eventually be implemented for other desktop
+environments that use this metaphor.
+<li><a href="../../samples/text">text</a>: demonstrates single and multiline text controls,
+and clipboard operations.
+<li><a href="../../samples/thread">thread</a>: tests the family of classes for doing thread
+programming.
+<li><a href="../../samples/toolbar">toolbar</a>: demonstrates wxToolBar.
+<li><a href="../../samples/treectrl">treectrl</a>: demonstrates wxTreeCtrl.
+<li><a href="../../samples/typetest">typetest</a>: tests various data type classes, including
+wxTime, wxDate and wxVariant.
+<li><a href="../../samples/validate">validate</a>: shows simple use of validation.
+<li><a href="../../samples/vscroll">vscroll</a>: shows use of wxVScrolledWindow.
+<li><a href="../../samples/wizard">wizard</a>: demonstrates the wxWizard class.
+<li><a href="../../samples/xrc">xrc</a>: demonstrates the XRC resource system.
+</ul>
+
+The following are deprecated samples.
+
+<ul>
+<li><a href="../../contrib/deprecated/samples/resource">resource</a>: shows how to use old-style wxWidgets resources (.wxr files).
+<li><a href="../../contrib/deprecated/samples/proplist">proplist</a>: demonstrates the property list classes (a VB-style property editor).
+<li><a href="../../contrib/deprecated/samples/treelay">treelay</a>: an algorithm for displaying tree hierarchies.
+</ul>
+
+
+<P>
+
+<table width=100% border=0 cellpadding=3 cellspacing=0>
+<tr>
+<td bgcolor="#004080" align=left height=24 background="images/bluetitlegradient.gif">
+<font size=+1 face="Arial, Lucida Sans, Helvetica" color="#FFFFFF">
+<b><a name="demos">Demos</a></b>
+</font>
+</td>
+</tr>
+</table>
+
+<P>
+
+The following are fully-fledged applications.<P>
<ul>
-<li><a href="gettext/gettext.htm">gettext manual</a>
-<li><a href="gettext/xgettext.htm">xgettext manual</a>
-<li><a href="gettext/msgfmt.htm">msgfmt manual</a>
+<li><a href="../../demos/bombs">bombs</a>: minesweeper-like game.
+<li><a href="../../demos/dbbrowse">dbbrowse</a>: ODBC database browser application.
+<li><a href="../../demos/forty">forty</a>: a great little card game by Chris Breeze.
+<li><a href="../../demos/fractal">fractal</a>: fractal mountains by Andrew Davison.
+<li><a href="../../demos/life">life</a>: the game of Life by J. H. Conway, implemented in wxWidgets by Guillermo Rodriguez Garcia.
+<li><a href="../../demos/poem">poem</a>: a little poetry display program.
</ul>
</font>
projects / wxWidgets.git / blobdiff