| | 1 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| | 2 | %% Name: tsamples.tex |
| | 3 | %% Purpose: Samples description |
| | 4 | %% Author: Vadim Zeitlin |
| | 5 | %% Modified by: |
| | 6 | %% Created: 02.11.99 |
| | 7 | %% RCS-ID: $Id$ |
| | 8 | %% Copyright: (c) wxWindows team |
| | 9 | %% Licence: wxWindows licence |
| | 10 | %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% |
| | 11 | |
| | 12 | \section{wxWindows samples}\label{samples} |
| | 13 | |
| | 14 | Probably the best way to learn wxWindows is by reading the source of some 50+ |
| | 15 | samples provided with it. Many aspects of wxWindows programming can be learnt |
| | 16 | from them, but sometimes it is not simple to just choose the right sample to |
| | 17 | look at. This overview aims at describing what each sample does/demonstrates to |
| | 18 | make it easier to find the relevant one if a simple grep through all sources |
| | 19 | didn't help. They also provide some notes about using the samples and what |
| | 20 | features of wxWindows are they supposed to test. |
| | 21 | |
| | 22 | \subsection{Font sample}\label{samplefont} |
| | 23 | |
| | 24 | The font sample demonstrates \helpref{wxFont}{wxfont}, |
| | 25 | \helpref{wxFontEnumerator}{wxfontenumerator} and |
| | 26 | \helpref{wxFontMapper}{wxfontmapper} classes. It allows you to see the fonts |
| | 27 | available (to wxWindows) on the computer and shows all characters of the |
| | 28 | chosen font as well. |
| | 29 | |
| | 30 | \subsection{DnD sample}\label{samplednd} |
| | 31 | |
| | 32 | This sample shows both clipboard and drag and drop in action. It is quite non |
| | 33 | trivial and may be safely used as a basis for implementing the clipboard and |
| | 34 | drag and drop operations in a real-life program. |
| | 35 | |
| | 36 | When you run the sample, its screen is split in several parts. On the top, |
| | 37 | there are two listboxes which show the standard derivations of |
| | 38 | \helpref{wxDropTarget}{wxdroptarget}: |
| | 39 | \helpref{wxTextDropTarget}{wxtextdroptarget} and |
| | 40 | \helpref{wxFileDropTarget}{wxfiledroptarget}. |
| | 41 | |
| | 42 | The middle of the sample window is taken by the log window which shows what is |
| | 43 | going on (of course, this only works in debug builds) and may be helpful to see |
| | 44 | the sequence of steps of data transfer. |
| | 45 | |
| | 46 | Finally, the last part is used for two things: you can drag text from it to |
| | 47 | either one of the listboxes (only one will accept it) or another application |
| | 48 | and, also, bitmap pasted from clipboard will be shown there. |
| | 49 | |
| | 50 | So far, everything we mentioned was implemented with minimal amount of code |
| | 51 | using standard wxWindows classes. The more advanced features are demonstrated |
| | 52 | if you create a shape frame from the main frame menu. A shape is a geometric |
| | 53 | object which has a position, size and color. It models some |
| | 54 | application-specific data in this sample. A shape object supports its own |
| | 55 | private \helpref{wxDataFormat}{wxdataformat} which means that you may cut and |
| | 56 | paste it or drag and drop (between one and the same or different shapes) from |
| | 57 | one sample instance to another (or the same). However, chances are that no |
| | 58 | other program supports this format and so shapes can also be rendered as |
| | 59 | bitmaps which allows them to be pasted/dropped in many other applications. |
| | 60 | |
| | 61 | Take a look at DnDShapeDataObject class to see how you may use |
| | 62 | \helpref{wxDataObject}{wxdataobject} to achieve this. |
| | 63 | |
projects / wxWidgets.git / blame_incremental