X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/15b6757b26a0277472a4f6b071b52050abd922da..b8afbac6aa1359906b9926794d6573d6e052afb7:/docs/doxygen/overviews/samples.h diff --git a/docs/doxygen/overviews/samples.h b/docs/doxygen/overviews/samples.h index e882069d24..24b4f94743 100644 --- a/docs/doxygen/overviews/samples.h +++ b/docs/doxygen/overviews/samples.h @@ -7,9 +7,9 @@ ///////////////////////////////////////////////////////////////////////////// /*! - + @page samples_overview wxWidgets samples - + Probably the best way to learn wxWidgets is by reading the source of some 50+ samples provided with it. Many aspects of wxWidgets programming can be learnt from them, but sometimes it is not simple to just choose the right sample to @@ -27,60 +27,60 @@ generic controls, such as buttons, listboxes, checkboxes, comboboxes etc. Other, more complicated controls, have their own samples. In this category you may find the following samples showing the corresponding controls: - - - - - - + + + + + + #wxCalendarCtrl - - - - + + + + Calendar a.k.a. date picker control - - - - - + + + + + #wxListCtrl - - - - + + + + List view control - - - - - + + + + + #wxTreeCtrl - - - - + + + + Tree view control - - - - - + + + + + #wxGrid - - - - + + + + Grid control - - - - - + + + + + Finally, it might be helpful to do a search in the entire sample directory if you can't find the sample showing the control you are interested in by name. Most classes contained in wxWidgets occur in at least one of the samples. - + @ref sampleminimal_overview @ref sampleanimate_overview @ref sampleartprovider_overview @@ -115,49 +115,49 @@ @ref sampletreectrl_overview @ref samplewidgets_overview @ref samplewizard_overview - - + + @section sampleminimal Minimal sample - + The minimal sample is what most people will know under the term Hello World, i.e. a minimal program that doesn't demonstrate anything apart from what is needed to write a program that will display a "hello" dialog. This is usually a good starting point for learning how to use wxWidgets. - - + + @section sampleanimate Animate sample - + The @c animate sample shows how you can use #wxAnimationCtrl control and shows concept of a platform-dependent animation encapsulated in #wxAnimation. - - + + @section sampleartprovider Art provider sample - + The @c artprov sample shows how you can customize the look of standard wxWidgets dialogs by replacing default bitmaps/icons with your own versions. It also shows how you can use wxArtProvider to get stock bitmaps for use in your application. - - + + @section samplecalendar Calendar sample - + This font shows the @ref calendarctrl_overview in action. It shows how to configure the control (see the different options in the calendar menu) and also how to process the notifications from it. - - + + @section sampleconfig Config sample - + This sample demonstrates the #wxConfig classes in a platform independent way, i.e. it uses text based files to store a given configuration under Unix and uses the Registry under Windows. See @ref config_overview for the descriptions of all features of this class. - - + + @section samplecontrols Controls sample - + The controls sample is the main test program for most simple controls used in wxWidgets. The sample tests their basic functionality, events, placement, modification in terms of colour and font as well as the possibility to change @@ -168,181 +168,181 @@ notebook pages, advancing pages programmatically and vetoing a page change by intercepting the #wxNotebookEvent. The various controls tested are listed here: - - - - - - + + + + + + #wxButton - - - - + + + + Push button control, displaying text - - - - - + + + + + #wxBitmapButton - - - - + + + + Push button control, displaying a bitmap - - - - - + + + + + #wxCheckBox - - - - + + + + Checkbox control - - - - - + + + + + #wxChoice - - - - + + + + Choice control (a combobox without the editable area) - - - - - + + + + + #wxComboBox - - - - + + + + A choice with an editable area - - - - - + + + + + #wxGauge - - - - + + + + A control to represent a varying quantity, such as time remaining - - - - - + + + + + #wxStaticBox - - - - + + + + A static, or group box for visually grouping related controls - - - - - + + + + + #wxListBox - - - - + + + + A list of strings for single or multiple selection - - - - - + + + + + wxSpinCtrl - - - - + + + + A spin ctrl with a text field and a 'up-down' control - - - - - + + + + + #wxSpinButton - - - - + + + + A spin or 'up-down' control - - - - - + + + + + #wxStaticText - - - - + + + + One or more lines of non-editable text - - - - - + + + + + #wxStaticBitmap - - - - + + + + A control to display a bitmap - - - - - + + + + + #wxRadioBox - - - - + + + + A group of radio buttons - - - - - + + + + + #wxRadioButton - - - - + + + + A round button to be used with others in a mutually exclusive way - - - - - + + + + + #wxSlider - - - - + + + + A slider that can be dragged by the user - - - - - - - + + + + + + + @section sampledebugrpt DebugRpt sample - + This sample shows how to use #wxDebugReport class to generate a debug report in case of a program crash or otherwise. On start up, it proposes to either crash itself (by dereferencing a @NULL pointer) or @@ -353,16 +353,16 @@ For the report processing part of the sample to work you should make available a Web server accepting form uploads, otherwise #wxDebugReportUpload will report an error. - - + + @section sampledialogs Dialogs sample - + This sample shows how to use the common dialogs available from wxWidgets. These dialogs are described in detail in the @ref commondialogs_overview. - - + + @section sampledialup Dialup sample - + This sample shows the #wxDialUpManager class. In the status bar, it displays the information gathered through its interface: in particular, the current connection status (online or offline) and @@ -372,10 +372,10 @@ Using the menu entries, you may also dial or hang up the line if you have a modem attached and (this only makes sense for Windows) list the available connections. - - + + @section samplednd DnD sample - + This sample shows both clipboard and drag and drop in action. It is quite non trivial and may be safely used as a basis for implementing the clipboard and drag and drop operations in a real-life program. @@ -406,19 +406,19 @@ programs as well - try Write/Wordpad, for example). Take a look at DnDShapeDataObject class to see how you may use #wxDataObject to achieve this. - - + + @section sampleevent Event sample - + The event sample demonstrates various features of the wxWidgets events. It shows using dynamic events and connecting/disconnecting the event handlers during run time and also using #PushEventHandler() and #PopEventHandler(). - - + + @section sampleexcept Except(ions) sample - + This very simple sample shows how to use C++ exceptions in wxWidgets programs, i.e. where to catch the exception which may be thrown by the program code. It doesn't do anything very exciting by itself, you need to study its code to @@ -426,10 +426,10 @@ You need to build the library with @c wxUSE_EXCEPTIONS being set to 1 and compile your code with C++ exceptions support to be able to build this sample. - - + + @section sampleexec Exec sample - + The exec sample demonstrates the #wxExecute and #wxShell functions. Both of them are used to execute the external programs and the sample shows how to do this synchronously (waiting @@ -438,24 +438,24 @@ synchronous and asynchronous cases and how to kill the processes with wxProcess::Kill and test for their existence with wxProcess::Exists. - - + + @section samplefont Font sample - + The font sample demonstrates #wxFont, #wxFontEnumerator and #wxFontMapper classes. It allows you to see the fonts available (to wxWidgets) on the computer and shows all characters of the chosen font as well. - - + + @section samplegrid Grid sample - + TODO. - - + + @section samplehtml HTML samples - + Eight HTML samples (you can find them in directory @c samples/html) cover all features of the HTML sub-library. @b Test demonstrates how to create #wxHtmlWindow @@ -477,10 +477,10 @@ #wxHtmlHelpController in your application while @e Helpview is a simple tool that only pops up the help window and displays help books given at command line. - - + + @section sampleimage Image sample - + The image sample demonstrates use of the #wxImage class and shows how to download images in a variety of formats, currently PNG, GIF, TIFF, JPEG, BMP, PNM and PCX. The top of the sample shows two rectangles, one @@ -497,10 +497,10 @@ replaced with red using wxImage::Replace. This sample also contains the code for testing the image rotation and resizing and using raw bitmap access, see the corresponding menu commands. - - + + @section sampleinternat Internat(ionalization) sample - + The not very clearly named internat sample demonstrates the wxWidgets internationalization (i18n for short from now on) features. To be more precise, it only shows localization support, i.e. support for translating the @@ -508,10 +508,10 @@ changing the other aspects of the programs behaviour. More information about this sample can be found in the @c readme.txt file in its directory. Please see also @ref internationalization_overview. - - + + @section samplelayout Layout sample - + The layout sample demonstrates the two different layout systems offered by wxWidgets. When starting the program, you will see a frame with some controls and some graphics. The controls will change their size whenever @@ -524,43 +524,43 @@ a #wxBoxSizer in a simple dialog and the other one showing how to use sizers in connection with a #wxNotebook class. See also #wxSizer. - - + + @section samplelistctrl Listctrl sample - + This sample shows the #wxListCtrl control. Different modes supported by the control (list, icons, small icons, report) may be chosen from the menu. The sample also provides some timings for adding/deleting/sorting a lot of (several thousands) items into the control. - - + + @section samplemediaplayer Mediaplayer sample - + This sample demonstrates how to use all the features of #wxMediaCtrl and play various types of sound, video, and other files. - + It replaces the old dynamic sample. - + @section samplenotebook Notebook sample - + This samples shows #wxBookCtrl family of controls. Although initially it was written to demonstrate #wxNotebook only, it can now be also used to see #wxListbook, #wxChoicebook and #wxTreebook in action. Test each of the controls, their orientation, images and pages using commands through menu. - - + + @section samplerender Render sample - + This sample shows how to replace the default wxWidgets #renderer and also how to write a shared library (DLL) implementing a renderer and load and unload it during the run-time. - - + + @section samplescrollsub Scroll subwindow sample - + This sample demonstrates use of the #wxScrolledWindow class including placing subwindows into it and drawing simple graphics. It uses the #SetTargetWindow method and thus the effect @@ -569,10 +569,10 @@ in particular using the wxWindow::IsExposed method with the aim to prevent unnecessary drawing in the window and thus reducing or removing flicker on screen. - - + + @section samplesockets Sockets sample - + The sockets sample demonstrates how to use the communication facilities provided by #wxSocket. There are two different applications in this sample: a server, which is implemented using a @@ -610,46 +610,46 @@ There is also a URL test which shows how to use the #wxURL class to fetch data from a given URL. The sockets sample is work in progress. Some things to do: - - + + More tests for basic socket functionality. More tests for protocol classes (wxProtocol and its descendants). Tests for the recently added (and still in alpha stage) datagram sockets. New samples which actually do something useful (suggestions accepted). - - - - + + + + @section samplesound Sound sample - + The @c sound sample shows how to use #wxSound for simple audio output (e.g. notifications). - - + + @section samplestatbar Statbar sample - + This sample shows how to create and use wxStatusBar. Although most of the samples have a statusbar, they usually only create a default one and only do it once. Here you can see how to recreate the statusbar (with possibly different number of fields) and how to use it to show icons/bitmaps and/or put arbitrary controls into it. - - + + @section sampletaborder Tab order sample - - This sample allows to test keyboard navigation (mostly done using the + + This sample allows to test keyboard navigation (mostly done using the @c TAB key, hence the sample name) between different controls. - It shows the use of - wxWindow::MoveBeforeInTabOrder() and + It shows the use of + wxWindow::MoveBeforeInTabOrder() and #MoveAfterInTabOrder() methods to change - the default order of the windows in the navigation chain and of + the default order of the windows in the navigation chain and of wxWindow::Navigate() for moving focus along this chain. - - + + @section sampletext Text sample - + This sample demonstrates four features: firstly the use and many variants of the #wxTextCtrl class (single line, multi line, read only, password, ignoring TAB, ignoring ENTER). @@ -665,10 +665,10 @@ best known from pasting text to the XTerm program. Last not least: some of the text controls have tooltips and the sample also shows how tooltips can be centrally disabled and their latency controlled. - - + + @section samplethread Thread sample - + This sample demonstrates use of threads in connection with GUI programs. There are two fundamentally different ways to use threads in GUI programs and either way has to take care of the fact that the GUI library itself usually @@ -684,14 +684,14 @@ and #wxMutexGuiLeave functions, both of which are used and tested in the sample as well. See also @ref thread_overview and #wxThread. - - + + @section sampletoolbar Toolbar sample - + The toolbar sample shows the #wxToolBar class in action. The following things are demonstrated: - - + + Creating the toolbar using wxToolBar::AddTool and wxToolBar::AddControl: see MyApp::InitToolbar in the sample. @@ -701,8 +701,8 @@ Using wxToolBar::DeleteTool and wxToolBar::InsertTool to dynamically update the toolbar. - - + + Some buttons in the main toolbar are check buttons, i.e. they stay checked when pressed. On the platforms which support it, the sample also adds a combobox to the toolbar showing how you can use arbitrary controls and not only buttons @@ -711,10 +711,10 @@ see the radio toolbar buttons in action: the first three buttons form a radio group, i.e. checking any of them automatically unchecks the previously checked one. - - + + @section sampletreectrl Treectrl sample - + This sample demonstrates using the #wxTreeCtrl class. Here you may see how to process various notification messages sent by this control and also when they occur (by looking at the messages in the text control in @@ -722,24 +722,24 @@ Adding, inserting and deleting items and branches from the tree as well as sorting (in default alphabetical order as well as in custom one) is demonstrated here as well - try the corresponding menu entries. - - + + @section samplewidgets Widgets sample - + The widgets sample is the main presentation program for most simple and advanced native controls and complex generic widgets provided by wxWidgets. The sample tests their basic functionality, events, placement, modification in terms of colour and font as well as the possibility to change the controls programmatically, such as adding an item to a list box etc. All widgets are categorized for easy browsing. - + @section samplewizard Wizard sample - + This sample shows the so-called wizard dialog (implemented using #wxWizard and related classes). It shows almost all features supported: - - + + Using bitmaps with the wizard and changing them depending on the page shown (notice that wxValidationPage in the sample has a different image from the other ones) @@ -754,7 +754,7 @@ but sometimes it depends on the user choices: wxCheckboxPage shows how to dynamically decide which page to display next (see also #wxWizardPage) - + */ - - + +