2a3476f24d
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@29615 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
436 lines
16 KiB
HTML
436 lines
16 KiB
HTML
<HTML>
|
|
|
|
<HEAD>
|
|
<TITLE>wxWidgets Documentation</TITLE>
|
|
|
|
</HEAD>
|
|
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000 VLINK="#63659C" LINK="#313063" ALINK="#313063">
|
|
|
|
<font face="Arial, Lucida Sans, Helvetica">
|
|
|
|
<a name="top"></a>
|
|
|
|
<IMG src="logo.gif" align=right hspace=10 vspace=0>
|
|
|
|
<b>Welcome to wxWidgets 2, 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.wxwindows.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="#samples">Samples</a>]
|
|
[<a href="#demos">Demos</a>]
|
|
</FONT>
|
|
</CENTER>
|
|
|
|
<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="install">Installation and release notes</a></b>
|
|
</font>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<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.
|
|
|
|
<P>
|
|
|
|
<ul>
|
|
<li>ReadMe: <a href="../readme.txt"><b>General ReadMe</b></a>,
|
|
<a href="../gtk/readme.txt">wxGTK</a>,
|
|
<a href="../motif/readme.txt">wxMotif</a>,
|
|
<a href="../x11/readme.txt">wxX11</a>,
|
|
<a href="../x11/readme-nanox.txt">wxNanoX</a>,
|
|
<a href="../msw/readme.txt">wxMSW</a>,
|
|
<a href="../mac/readme.txt">wxMac</a>,
|
|
<a href="../mgl/readme.txt">wxMGL</a>,
|
|
<a href="../univ/readme.txt">Univ</a>
|
|
<li>Installation: <a href="../gtk/install.txt">wxGTK</a>,
|
|
<a href="../motif/install.txt">wxMotif</a>,
|
|
<a href="../x11/install.txt">wxX11</a>,
|
|
<a href="../msw/install.txt">wxMSW</a>,
|
|
<a href="../mac/install.txt">wxMac</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>, <a href="../gtk/changes.txt">wxGTK change log</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><a href="faq.htm"><B>FAQ</B></a>:
|
|
<ul>
|
|
<li><a href="faqgen.htm">General questions</a>
|
|
<li><a href="faqgtk.htm">wxWidgets 2 for GTK+</a>
|
|
<li><a href="faqmsw.htm">wxWidgets 2 for Windows</a>
|
|
<li><a href="faqmot.htm">wxWidgets 2 for Motif</a>
|
|
<li><a href="faqx11.htm">wxWidgets 2 for X11</a>
|
|
<li><a href="faqmac.htm">wxWidgets 2 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>,
|
|
<a href="../mac/todo.txt">wxMac</a>
|
|
<li>List of <a href="../symbols.txt">preprocessor symbols</a> used in wxWidgets
|
|
</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>
|
|
|
|
See also the <a href="../pdf/wxTutorial.pdf">wxWidgets Tutorial</a>
|
|
by Franky Braem, in PDF format.<P>
|
|
|
|
<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>
|
|
|
|
<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="gettext/index.html">gettext Manual</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="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/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>: wxDB ODBC 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/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/event">event</a>: demonstrates event 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/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/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/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/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/sockets">sockets</a>: demonstrates the TCP/IP family of classes.
|
|
<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/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="../../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>
|
|
|
|
</BODY>
|
|
|
|
</HTML>
|
|
|