documentation file for each class it finds, using comments as appropriate.
This is a good way to start a reference for a set of classes.
-\item[{\bf Dialog Editor}]
-Dialog Editor allows interactive construction of dialogs using
-absolute positioning, producing WXR output files. This tool is generally deprecated
-in favour of sizer-based tools. You can find Dialog Editor
-in {\tt utils/dialoged}.
-
+%\item[{\bf Dialog Editor}]
+%Dialog Editor allows interactive construction of dialogs using
+%absolute positioning, producing WXR output files. This tool is generally deprecated
+%in favour of sizer-based tools. You can find Dialog Editor
+%in {\tt utils/dialoged}.
+%
\item[{\bf XRC resource system}]
-This is the sizer-aware replacement for the WXR resource system, and uses
+This is the sizer-aware resource system, and uses
XML-based resource specifications that can be generated by tools
such as \urlref{wxDesigner}{http://www.roebling.de} and XRC's own wxrcedit.
You can find this in {\tt contrib/src/xrc}, {\tt contrib/include/wx/xrc}, {\tt contrib/samples/xrc}, and {\tt contrib/utils/wxrcedit}.
\subsection{Use wxWindows resource files}
-Use .wrc (wxWindows resource files) where possible, because they can be easily changed
-independently of source code. Bitmap resources can be set up to load different
-kinds of bitmap depending on platform (see the section on resource files).
+Use .xrc (wxWindows resource files) where possible, because they can be easily changed
+independently of source code.
\section{Strategies for debugging}\label{debugstrategies}
\input treectrl.tex
\input treeevt.tex
\input treedata.tex
-\input treelay.tex
\input upduievt.tex
\input url.tex
\input validatr.tex
}
\end{verbatim}
-A dialog may be loaded from a wxWindows resource file (extension {\tt wxr}),
-which may itself be created by Dialog Editor. For details, see
-\helpref{The wxWindows resource system}{resourceformats},
-\helpref{wxWindows resource functions}{resourcefuncs}
-and the resource sample.
-
An application can define an \helpref{wxCloseEvent}{wxcloseevent} handler for
the dialog to respond to system close events.
\wxheading{See also}
-\helpref{wxDialog overview}{wxdialogoverview}, \helpref{wxFrame}{wxframe}, \helpref{Resources}{resources},\rtfsp
+\helpref{wxDialog overview}{wxdialogoverview}, \helpref{wxFrame}{wxframe},\rtfsp
\helpref{Validator overview}{validatoroverview}
\latexignore{\rtfignore{\wxheading{Members}}}
\helpref{wxRegisterId}{wxregisterid}\\
\helpref{wxRemoveFile}{wxremovefile}\\
\helpref{wxRenameFile}{wxrenamefile}\\
-\helpref{wxResourceAddIdentifier}{wxresourceaddidentifier}\\
-\helpref{wxResourceClear}{wxresourceclear}\\
-\helpref{wxResourceCreateBitmap}{wxresourcecreatebitmap}\\
-\helpref{wxResourceCreateIcon}{wxresourcecreateicon}\\
-\helpref{wxResourceCreateMenuBar}{wxresourcecreatemenubar}\\
-\helpref{wxResourceGetIdentifier}{wxresourcegetidentifier}\\
-\helpref{wxResourceParseData}{wxresourcedata}\\
-\helpref{wxResourceParseFile}{wxresourceparsefile}\\
-\helpref{wxResourceParseString}{wxresourceparsestring}\\
-\helpref{wxResourceRegisterBitmapData}{registerbitmapdata}\\
-\helpref{wxResourceRegisterIconData}{wxresourceregistericondata}\\
\helpref{wxRmdir}{wxrmdir}\\
\helpref{wxSafeShowMessage}{wxsafeshowmessage}\\
\helpref{wxSafeYield}{wxsafeyield}\\
where {\tt file.ext} is a file that the resource compiler can find.
-One use of this is to store {\tt .wxr} files instead of including the data in the C++ file; some compilers
-cannot cope with the long strings in a {\tt .wxr} file. The resource data can then be parsed
-using \helpref{wxResourceParseString}{wxresourceparsestring}.
-
This function is available under Windows only.
\wxheading{Include files}
\helpref{wxDynamicCast}{wxdynamiccast}\\
\helpref{wxConstCast}{wxconstcast}
-\section{Resource functions}\label{resourcefuncs}
-
-\overview{Resource functions}{resourceformats}
-
-This section details functions for manipulating wxWindows (.WXR) resource
-files and loading user interface elements from resources.
-
-\normalbox{Please note that this use of the word `resource' is different from that used when talking
-about initialisation file resource reading and writing, using such functions
-as wxWriteResource and wxGetResource. It is just an unfortunate clash of terminology.}
-
-\helponly{For an overview of the wxWindows resource mechanism, see \helpref{the wxWindows resource system}{resourceformats}.}
-
-See also \helpref{wxWindow::LoadFromResource}{wxwindowloadfromresource} for
-loading from resource data.
-
-\membersection{::wxResourceAddIdentifier}\label{wxresourceaddidentifier}
-
-\func{bool}{wxResourceAddIdentifier}{\param{const wxString\& }{name}, \param{int }{value}}
-
-Used for associating a name with an integer identifier (equivalent to dynamically\rtfsp
-{\tt\#}defining a name to an integer). Unlikely to be used by an application except
-perhaps for implementing resource functionality for interpreted languages.
-
-\membersection{::wxResourceClear}\label{wxresourceclear}
-
-\func{void}{wxResourceClear}{\void}
-
-Clears the wxWindows resource table.
-
-\membersection{::wxResourceCreateBitmap}\label{wxresourcecreatebitmap}
-
-\func{wxBitmap *}{wxResourceCreateBitmap}{\param{const wxString\& }{resource}}
-
-Creates a new bitmap from a file, static data, or Windows resource, given a valid
-wxWindows bitmap resource identifier. For example, if the .WXR file contains
-the following:
-
-\begin{verbatim}
-static const wxString\& project_resource = "bitmap(name = 'project_resource',\
- bitmap = ['project', wxBITMAP_TYPE_BMP_RESOURCE, 'WINDOWS'],\
- bitmap = ['project.xpm', wxBITMAP_TYPE_XPM, 'X']).";
-\end{verbatim}
-
-then this function can be called as follows:
-
-\begin{verbatim}
- wxBitmap *bitmap = wxResourceCreateBitmap("project_resource");
-\end{verbatim}
-
-\membersection{::wxResourceCreateIcon}\label{wxresourcecreateicon}
-
-\func{wxIcon *}{wxResourceCreateIcon}{\param{const wxString\& }{resource}}
-
-Creates a new icon from a file, static data, or Windows resource, given a valid
-wxWindows icon resource identifier. For example, if the .WXR file contains
-the following:
-
-\begin{verbatim}
-static const wxString\& project_resource = "icon(name = 'project_resource',\
- icon = ['project', wxBITMAP_TYPE_ICO_RESOURCE, 'WINDOWS'],\
- icon = ['project', wxBITMAP_TYPE_XBM_DATA, 'X']).";
-\end{verbatim}
-
-then this function can be called as follows:
-
-\begin{verbatim}
- wxIcon *icon = wxResourceCreateIcon("project_resource");
-\end{verbatim}
-
-\membersection{::wxResourceCreateMenuBar}\label{wxresourcecreatemenubar}
-
-\func{wxMenuBar *}{wxResourceCreateMenuBar}{\param{const wxString\& }{resource}}
-
-Creates a new menu bar given a valid wxWindows menubar resource
-identifier. For example, if the .WXR file contains the following:
-
-\begin{verbatim}
-static const wxString\& menuBar11 = "menu(name = 'menuBar11',\
- menu = \
- [\
- ['&File', 1, '', \
- ['&Open File', 2, 'Open a file'],\
- ['&Save File', 3, 'Save a file'],\
- [],\
- ['E&xit', 4, 'Exit program']\
- ],\
- ['&Help', 5, '', \
- ['&About', 6, 'About this program']\
- ]\
- ]).";
-\end{verbatim}
-
-then this function can be called as follows:
-
-\begin{verbatim}
- wxMenuBar *menuBar = wxResourceCreateMenuBar("menuBar11");
-\end{verbatim}
-
-
-\membersection{::wxResourceGetIdentifier}\label{wxresourcegetidentifier}
-
-\func{int}{wxResourceGetIdentifier}{\param{const wxString\& }{name}}
-
-Used for retrieving the integer value associated with an identifier.
-A zero value indicates that the identifier was not found.
-
-See \helpref{wxResourceAddIdentifier}{wxresourceaddidentifier}.
-
-\membersection{::wxResourceParseData}\label{wxresourcedata}
-
-\func{bool}{wxResourceParseData}{\param{const wxString\& }{resource}, \param{wxResourceTable *}{table = NULL}}
-
-Parses a string containing one or more wxWindows resource objects. If
-the resource objects are global static data that are included into the
-C++ program, then this function must be called for each variable
-containing the resource data, to make it known to wxWindows.
-
-{\it resource} should contain data in the following form:
-
-\begin{verbatim}
-dialog(name = 'dialog1',
- style = 'wxCAPTION | wxDEFAULT_DIALOG_STYLE',
- title = 'Test dialog box',
- x = 312, y = 234, width = 400, height = 300,
- modal = 0,
- control = [1000, wxStaticBox, 'Groupbox', '0', 'group6', 5, 4, 380, 262,
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0]],
- control = [1001, wxTextCtrl, '', 'wxTE_MULTILINE', 'text3',
- 156, 126, 200, 70, 'wxWindows is a multi-platform, GUI toolkit.',
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0],
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0]]).
-\end{verbatim}
-
-This function will typically be used after including a {\tt .wxr} file into
-a C++ program as follows:
-
-\begin{verbatim}
-#include "dialog1.wxr"
-\end{verbatim}
-
-Each of the contained resources will declare a new C++ variable, and each
-of these variables should be passed to wxResourceParseData.
-
-\membersection{::wxResourceParseFile}\label{wxresourceparsefile}
-
-\func{bool}{wxResourceParseFile}{\param{const wxString\& }{filename}, \param{wxResourceTable *}{table = NULL}}
-
-Parses a file containing one or more wxWindows resource objects
-in C++-compatible syntax. Use this function to dynamically load
-wxWindows resource data.
-
-\membersection{::wxResourceParseString}\label{wxresourceparsestring}
-
-\func{bool}{wxResourceParseString}{\param{char *}{s}, \param{wxResourceTable *}{table = NULL}}
-
-Parses a string containing one or more wxWindows resource objects. If
-the resource objects are global static data that are included into the
-C++ program, then this function must be called for each variable
-containing the resource data, to make it known to wxWindows.
-
-{\it resource} should contain data with the following form:
-
-\begin{verbatim}
-dialog(name = 'dialog1',
- style = 'wxCAPTION | wxDEFAULT_DIALOG_STYLE',
- title = 'Test dialog box',
- x = 312, y = 234, width = 400, height = 300,
- modal = 0,
- control = [1000, wxStaticBox, 'Groupbox', '0', 'group6', 5, 4, 380, 262,
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0]],
- control = [1001, wxTextCtrl, '', 'wxTE_MULTILINE', 'text3',
- 156, 126, 200, 70, 'wxWindows is a multi-platform, GUI toolkit.',
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0],
- [11, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0]]).
-\end{verbatim}
-
-This function will typically be used after calling \helpref{wxLoadUserResource}{wxloaduserresource} to
-load an entire {\tt .wxr file} into a string.
-
-\membersection{::wxResourceRegisterBitmapData}\label{registerbitmapdata}
-
-\func{bool}{wxResourceRegisterBitmapData}{\param{const wxString\& }{name}, \param{char *}{xbm\_data}, \param{int }{width},
-\param{int }{height}, \param{wxResourceTable *}{table = NULL}}
-
-\func{bool}{wxResourceRegisterBitmapData}{\param{const wxString\& }{name}, \param{char **}{xpm\_data}}
-
-Makes {\tt\#}included XBM or XPM bitmap data known to the wxWindows resource system.
-This is required if other resources will use the bitmap data, since otherwise there
-is no connection between names used in resources, and the global bitmap data.
-
-\membersection{::wxResourceRegisterIconData}\label{wxresourceregistericondata}
-
-Another name for \helpref{wxResourceRegisterBitmapData}{registerbitmapdata}.
-
\section{Log functions}\label{logfunctions}
These functions provide a variety of logging functions: see \helpref{Log classes overview}{wxlogoverview} for
By default, a panel has the same colouring as a dialog.
-A panel may be loaded from a wxWindows resource file (extension {\tt wxr}).
-
\wxheading{See also}
\helpref{wxDialog}{wxdialog}
+++ /dev/null
-%!PS-Adobe-2.0 EPSF-2.0
-%%Title: prop1.eps
-%%Creator: XV Version 2.20 Rev: 4/24/92 - by John Bradley
-%%BoundingBox: 167 292 445 500
-%%Pages: 1
-%%DocumentFonts:
-%%EndComments
-%%EndProlog
-
-%%Page: 1 1
-
-% remember original state
-/origstate save def
-
-% build a temporary dictionary
-20 dict begin
-
-% lower left corner
-167 292 translate
-
-% size of image (on paper, in 1/72inch coords)
-278 208 scale
-
-% define 'colorimage' if it isn't defined
-% ('colortogray' and 'mergeprocs' come from xwd2ps
-% via xgrab)
-/colorimage where % do we know about 'colorimage'?
- { pop } % yes: pop off the 'dict' returned
- { % no: define one
- /colortogray { % define an RGB->I function
- /rgbdata exch store % call input 'rgbdata'
- rgbdata length 3 idiv
- /npixls exch store
- /rgbindx 0 store
- /grays npixls string store % str to hold the result
- 0 1 npixls 1 sub {
- grays exch
- rgbdata rgbindx get 20 mul % Red
- rgbdata rgbindx 1 add get 32 mul % Green
- rgbdata rgbindx 2 add get 12 mul % Blue
- add add 64 idiv % I = .5G + .31R + .18B
- put
- /rgbindx rgbindx 3 add store
- } for
- grays
- } bind def
-
- % Utility procedure for colorimage operator.
- % This procedure takes two procedures off the
- % stack and merges them into a single procedure.
-
- /mergeprocs { % def
- dup length
- 3 -1 roll
- dup
- length
- dup
- 5 1 roll
- 3 -1 roll
- add
- array cvx
- dup
- 3 -1 roll
- 0 exch
- putinterval
- dup
- 4 2 roll
- putinterval
- } bind def
-
- /colorimage { % def
- pop pop % remove 'false 3' operands
- {colortogray} mergeprocs
- image
- } bind def
- } ifelse % end of 'false' case
-
-
-
-% define the colormap
-/cmap 42 string def
-
-
-% load up the colormap
-currentfile cmap readhexstring
-000000 bf0000 00bf00 bfbf00 0000bf 00bfbf c0c0c0 808080 ff0000 00ff00
-ffff00 0000ff 00ffff ffffff
-pop pop % lose return values from readhexstring
-
-
-% rlecmapimage expects to have 'w h bits matrix' on stack
-/rlecmapimage {
- /buffer 1 string def
- /rgbval 3 string def
- /block 384 string def
-
- % proc to read a block from file, and return RGB data
- { currentfile buffer readhexstring pop
- /bcount exch 0 get store
- bcount 128 ge
- { % it's a non-run block
- 0 1 bcount 128 sub
- { currentfile buffer readhexstring pop pop
-
- % look up value in color map
- /rgbval cmap buffer 0 get 3 mul 3 getinterval store
-
- % and put it in position i*3 in block
- block exch 3 mul rgbval putinterval
- } for
- block 0 bcount 127 sub 3 mul getinterval
- }
-
- { % else it's a run block
- currentfile buffer readhexstring pop pop
-
- % look up value in colormap
- /rgbval cmap buffer 0 get 3 mul 3 getinterval store
-
- 0 1 bcount { block exch 3 mul rgbval putinterval } for
-
- block 0 bcount 1 add 3 mul getinterval
- } ifelse
- } % end of proc
- false 3 colorimage
-} bind def
-
-
-278 208 8 % dimensions of data
-[278 0 0 -208 0 208] % mapping matrix
-rlecmapimage
-
-7f067f0614060000
-81060d7f0d7f0d110d810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d068106047f047f040c040106810700
-82060d068106048204060d820d060783070d0702010203098102047f047a040106810700
-
-82060d068106048704060b060001020781070283020702098109028102047f0446040e0d
-81000d0d0d81000481040d0d0d81000481040682060700
-82060d0681060482040806810600820002078507020902070201028109047f044604810d
-060b068307000d060b068207000482040d060b068207000481040682060700
-82060d0681060481040685060800040307820702098409020702098109040104050d2d04
-030d0204010d1a04050d6604810d060b068307000d06810600070001068207000482040d
-060b068207000481040682060700
-82060d068106048704060b0604000a0789070209020702070209040104010d0204010d1d
-04010d0b04010d0104010d0104010d1204010d0704010d1004010d5504810d060b068307
-000d06810600070001068207000482040d06010601000306010001068207000481040682
-060700
-82060d068106048204070681060001000107010286070209020702040104010d0204010d
-1d04010d0b04010d0504010d1204010d0704010d1004010d5504810d060b068307000d06
-820600060506810006830607000482040d06020601000106010002068207000481040682
-060700
-82060d0681060485040d0607060d010d8407020002090109820200040104010d0204010d
-81040d010d0104030d0104040d0204030d0104020d81040d010d81040d820d040d810d04
-0304010d0504040d0204030d0204030d0104020d0604010d0404030d0204020d0104020d
-5404810d060b068307000d06820600060506810006830607000482040d06030603000306
-8207000481040682060700
-82060d068106048104070507010006020204050d0104010d0104010d0104010d81040d81
-0d0481040d820d040d810d0481040d820d040d810d0481040d810d0481040d820d040d81
-0d040404030d0204020d81040d820d040d810d0481040d820d040d810d0481040d820d04
-0d810d040604010d0304010d0104010d81040d820d040d820d040d810d045404810d060b
-068307000d06820600060506810006830607000482040d06040601000406820700048104
-0682060700
-82060d068106048104050505010006030204010d0504010d0104010d0104010d81040d81
-0d0481040d820d040d040d81040d810d0481040d810d0481040d820d040d810d04070401
-0d0104010d0104010d81040d040d81040d040d81040d810d040604010d0304050d010401
-0d0204010d5504810d060b068307000d06820600060506810006830607000482040d0603
-06030003068207000481040682060700
-82060d0681060481040c010c8205080c830c05030a020a81030a810a040104010d050401
-0d0104010d0104010d81040d810d0481040d820d040d810d040304010d0104010d010401
-0d81040d810d040704010d0104010d0104010d81040d810d040304010d0404010d070401
-0d0304010d0604010d0104010d5504810d060b068307000d068206000605068100068306
-07000482040d06020601000106010002068207000481040682060700
-82060d068106048c040c05070507050c05030a030a840a03000a040104010d0504010d01
-04010d0104010d81040d810d0481040d820d040d810d0481040d820d040d810d0481040d
-810d040104020d0504010d0104010d0104010d0104010d81040d810d0481040d820d040d
-810d0481040d820d040d810d040604010d0304010d0104010d81040d820d040d820d040d
-810d045404810d060106050003068307000d06820600060506810006830607000482040d
-06010601000306010001068207000481040682060700
-82060d0681060482040c08020886070c05030a030a010a82030a040104010d0504010d02
-04030d0104040d0204030d0104010d0204010d0104010d0704030d0204010d0104010d01
-04030d0204030d0204010d0604010d0404030d0204020d0204010d5404810d0601060500
-03068307000d06810600070001068207000482040d060b068207000481040682060700
-82060d0681060482040c080208010c8205030a810a0384030a030a041404010d1404010d
-7f041804810d060b068307000d060b068207000482040d060b0682070004810406820607
-00
-82060d0681060482040c080308850c05030a030a010a82000a041404010d1204020d7f04
-1904810d070c0782000d070c0781000482040d070c0781000481040682060700
-82060d0681060483040c05080208850c05030a030a810a0382030a047f0446041f000104
-0f0001040106810700
-82060d0681060481040c050c8205030a050a7f047b040106810700
-82060d068106047f047f040c040106810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d0637067f073907810d061c06810700
-82060d06030616000306160001068107007f00360082060d0681060015000406810700
-82060d06020681000d140d820700068206000d140d8507000607000d7f0d350d84060d06
-000d140d820700060206810700
-82060d06020682000d06120601078100068306000d061206010784000607000d7f0d350d
-84060d06000d130d01078100060206810700
-82060d06020682000d06120601078100068306000d061206010784000607000d7f0d350d
-84060d06000d810d06110601078100060206810700
-82060d06020682000d06120601078100068306000d061206010784000607000d7f0d350d
-84060d06000d810d06110601078100060206810700
-82060d06020682000d0603068100060606810006030601078100068306000d0612060107
-84000607000d820d000d7f0d320d84060d06000d810d06110601078100060206810700
-82060d06020682000d06030683000600060306810006040601078100068306000d061206
-010785000607000d0081000d7f0d320d84060d06000d810d061106010781000602068107
-00
-82060d06020682000d06040683000600060106810006050601078100068306000d060b06
-8100060406010785000607000d000100810d0081000d820d000d810d0081000d810d0002
-007f0d220d84060d06000d810d06110601078100060206810700
-82060d06020682000d06050685000600060006060601078100068306000d060a06830006
-00060306010785000607000d0081000d810d0082000d000100810d0082000d0081000d81
-0d0081000d7f0d200d84060d06000d810d06110601078100060206810700
-82060d06020682000d0606068300060006070601078100068306000d0609068300060006
-0406010785000607000d0081000d810d0082000d000100810d0082000d0081000d810d00
-81000d7f0d200d84060d06000d810d06110601078100060206810700
-82060d06020682000d0607068300060006060601078100068306000d0604068100060106
-83000600060506010785000607000d0081000d010d0200810d000100010d0100010d0100
-7f0d210d84060d06000d810d06110601078100060206810700
-82060d06020682000d06060685000600060006050601078100068306000d060306870006
-0006000600060606010785000607000d0081000d010d0200810d000100010d0100010d01
-007f0d210d84060d06000d810d06110601078100060206810700
-82060d06020682000d06050681000601068300060006040601078100068306000d060406
-850006000600060706010784000607000d810d0081000d810d0081000d010d0100020d03
-007f0d220d84060d06000d810d0603060100810600820006008100060406010781000602
-06810700
-82060d06020682000d06040681000603068300060006030601078100068306000d060506
-83000600060806010784000607000d7f0d350d84060d06000d810d060306010081060082
-000600810006040601078100060206810700
-82060d06020682000d060306010005060100040601078100068306000d06060681000609
-06010784000607000d7f0d350d84060d06000d810d06110601078100060206810700
-82060d06020682000d06120601078100068306000d061206010784000607000d7f0d350d
-84060d06000d810d06110601078100060206810700
-82060d06020682000d06120601078100068306000d061206010784000607000d7f0d350d
-84060d06000d810d06110601078100060206810700
-82060d06020682000d0714078100068306000d07140784000607000d7f0d350d85060d06
-000d0714078100060206810700
-82060d06020682000d0714078100068306000d07140784000607000d7f0d350d84060d06
-000715078100060206810700
-82060d06030616000306160001068207000d7f0d350d82060d0681060015000406810700
-
-82060d0637068107067f063706810d061c06810700
-82060d0637067f0d3a0d1d06810700
-82060d0601067f077f070a07810d060106810700
-82060d0601068107007f007f00070082060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d010d0300010d0400020d03007f0d720d82060d060106810700
-82060d0601068207000d810d0081000d810d0082000d0081000d810d0082000d0081000d
-810d0081000d7f0d700d82060d060106810700
-82060d0601068207000d810d0081000d810d0082000d0081000d810d0082000d0004007f
-0d710d82060d060106810700
-82060d0601068207000d810d0081000d810d0082000d0081000d810d0082000d0081000d
-7f0d740d82060d060106810700
-82060d0601068207000d810d0081000d810d0082000d0081000d810d0082000d0081000d
-810d0081000d7f0d700d82060d060106810700
-82060d0601068207000d010d0300010d0100010d0100010d03007f0d720d82060d060106
-810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d060106ff0700040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040aff040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a8c040a040a040a040a040a060d060106810700
-82060d0601068307000a047f047f04050482060d060106810700
-82060d060106820700047f047f040504830a060d060106810700
-82060d0601068307000a0482040d047f047f04020482060d060106810700
-82060d0601068207000481040d810d047f047f040104830a060d060106810700
-82060d0601068307000a0d020d81040d810d0482040d0481040d810d0481040d020d7f04
-720482060d060106810700
-82060d0601068207000481040d810d0481040d820d040d010d81040d820d040d810d0481
-040d810d047f046f04830a060d060106810700
-82060d0601068407000a040d810d0481040d820d040d010d81040d820d040d810d048104
-0d810d047f04700482060d060106810700
-82060d0601068207000481040d810d040104020d81040d010d0104010d0104010d7f0470
-04830a060d060106810700
-82060d0601068407000a040d810d040104020d81040d010d0104010d0104010d7f047104
-82060d060106810700
-82060d060106820700040104010d0104010d0204010d0204030d7f047104830a060d0601
-06810700
-82060d0601068307000a047f047f04050482060d060106810700
-82060d060106820700047f047f040504830a060d060106810700
-82060d060106ff07000a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a
-040a040a040a040a040a040a040a040a040a040a040a040a040a04ff0a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a040a04
-0a040a040a040a040a040a048c0a040a040a040a040a04060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d010d81000d810d0081000d7f0d7e0d82060d060106810700
-82060d0601068207000d810d0081000d810d0081000d7f0d7e0d82060d060106810700
-82060d0601068307000d000200810d000300010d0300010d0300020d03007f0d690d8206
-0d060106810700
-82060d0601068207000d810d0081000d810d0081000d810d0082000d0081000d010d0100
-010d0100810d0081000d810d0081000d7f0d670d82060d060106810700
-82060d0601068207000d810d0081000d810d0081000d810d0082000d0081000d010d0500
-810d0004007f0d680d82060d060106810700
-82060d0601068207000d810d0081000d810d0081000d810d0082000d0081000d010d0100
-040d01007f0d6c0d82060d060106810700
-82060d0601068207000d810d0081000d810d0081000d810d0082000d0081000d010d0100
-010d0100810d0081000d810d0081000d7f0d670d82060d060106810700
-82060d0601068207000d010d0100810d0081000d810d0082000d0081000d020d0300020d
-03007f0d690d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068207000d7f0d7f0d060d82060d060106810700
-82060d0601068107067f067f060806810d060106810700
-82060d0601067f0d7f0d0b0d0206810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d0601067f077f070b070206810700
-82060d0601068107007f007f000800810d060106810700
-82060d0601068207000d7f0d760d0e060100810d060106810700
-82060d0601068207000d7f0d760d81060d0b0d81070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d1c0d0100120d01000e0d81000d6b0d0400400d82060d060a0681
-070082000d060106810700
-82060d0601068207000d010d81000d190d81000d120d81000d7b0d85000d000d000d3f0d
-82060d060a0681070082000d060106810700
-82060d0601068207000d810d000300030d0200010d0100010d0100020d0100810d008400
-0d000d0081000d090d0300010d82000d0081000d020d0200020d0200040d0300020d0200
-5f0d81000d020d0100810d0082000d0081000d810d0081000d010d02002c0d82060d0603
-06810006040681070082000d060106810700
-82060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d820d
-000d810d0081000d810d0081000d820d000d070d81000d010d81000d810d0081000d820d
-000d820d000d010d81000d020d81000d020d81000d010d81000d820d000d010d81000d5d
-0d81000d030d0100030d81000d010d81000d820d000d010d81000d2a0d82060d06020602
-00040681070082000d060106810700
-82060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d820d
-000d010d81000d820d000d010d81000d070d81000d040d81000d010d81000d820d000d01
-0d81000d020d81000d020d81000d040d04005e0d81000d030d81000d030d81000d010d81
-000d810d0003002b0d82060d0601060400030681070082000d060106810700
-82060d0601068207000d010d81000d010d81000d820d000d010d81000d820d000d810d00
-81000d820d000d010d81000d820d000d010d81000d070d81000d040d81000d010d81000d
-820d000d010d81000d020d81000d020d81000d040d81000d610d81000d030d81000d030d
-81000d810d0081000d820d000d2e0d82060d068106000500020681070082000d06010681
-0700
-82060d0601068207000d020d0200030d0200030d0100810d0081000d810d000200810d00
-0100810d000100080d0300810d000100810d000100010d0200020d0400020d0300020d03
-005d0d0200020d0300030d0100810d0081000d810d0002002b0d82060d060a0681070082
-000d060106810700
-82060d0601068207000d1a0d81000d7f0d590d82060d060a0681070082000d0601068107
-00
-82060d0601068207000d170d02007f0d5b0d82060d060a0681070082000d060106810700
-
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d8106070c070100810d060106810700
-82060d0601068207000d7f0d760d1000810d060106810700
-82060d0601068207000d7f0d760d92060d060d060d060d060d060d060d060d000d060106
-810700
-82060d0601068207000d7f0d770d91060d060d060d060d060d060d060d06000d06010681
-0700
-82060d0601068207000d030d81000d7f0d2d0d81000d020d0300390d92060d060d060d06
-0d060d060d060d060d000d060106810700
-82060d0601068207000d7f0d320d0100030d81000d3c0d91060d060d060d060d060d060d
-060d06000d060106810700
-82060d0601068207000d010d0200040d0200010d0100810d0081000d7f0d1c0d83000d00
-0d020d81000d3b0d92060d060d060d060d060d060d060d060d000d060106810700
-82060d0601068207000d030d81000d020d81000d010d81000d810d0081000d820d000d7f
-0d1a0d81000d820d000d020d02003b0d91060d060d060d060d060d060d060d06000d0601
-06810700
-82060d0601068207000d030d81000d030d0300010d81000d010d81000d7f0d1a0d040005
-0d81000d380d92060d060d060d060d060d060d060d060d000d060106810700
-82060d0601068207000d030d81000d020d81000d010d81000d820d000d010d81000d7f0d
-1d0d81000d010d81000d010d81000d380d0e060100810d060106810700
-82060d0601068207000d010d0400010d0800810d0001007f0d1c0d0200020d02003a0d81
-060d0b0d81070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d810d0081000d060d81000d030d0100040d01007f0d170d020003
-0d0300390d82060d060a0681070082000d060106810700
-82060d0601068207000d010d81000d0d0d81000d040d81000d7f0d150d81000d010d8100
-0d010d81000d3b0d82060d060a0681070082000d060106810700
-82060d0601068207000d010d82000d0081000d010d0200050d81000d040d81000d7f0d18
-0d81000d020d81000d3b0d82060d060a0681070082000d060106810700
-82060d0601068207000d010d0100010d81000d020d81000d040d81000d040d81000d7f0d
-170d81000d030d02003a0d82060d060a0681070082000d060106810700
-82060d0601068207000d010d81000d010d81000d020d81000d040d81000d040d81000d7f
-0d160d81000d070d81000d380d82060d060a0681070082000d060106810700
-82060d0601068207000d010d81000d010d81000d020d81000d040d81000d040d81000d7f
-0d150d81000d040d81000d010d81000d380d82060d060a0681070082000d060106810700
-
-82060d0601068207000d810d000300020d0400010d0400010d04007f0d140d0400020d02
-003a0d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d030d81000d0a0d0100050d81000d7f0d5b0d82060d060a068107
-0082000d060106810700
-82060d0601068207000d110d81000d7f0d620d82060d060a0681070082000d0601068107
-00
-82060d0601068207000d010d0300010d0100010d0100030d81000d020d0200040d020001
-0d0100810d0081000d7f0d070d0200010d0100810d0081000d020d0200330d82060d060a
-0681070082000d060106810700
-82060d0601068207000d040d81000d010d81000d010d81000d020d81000d040d81000d02
-0d81000d010d81000d810d0081000d820d000d7f0d050d81000d010d81000d810d008100
-0d820d000d820d000d010d81000d310d82060d060a0681070082000d060106810700
-82060d0601068207000d040d81000d010d81000d010d81000d020d81000d040d81000d03
-0d0300010d81000d010d81000d7f0d050d81000d010d81000d820d000d010d81000d810d
-000300320d82060d060a0681070082000d060106810700
-82060d0601068207000d040d81000d010d81000d810d0081000d020d81000d040d81000d
-020d81000d010d81000d820d000d010d81000d7f0d050d81000d010d81000d820d000d01
-0d81000d820d000d350d82060d060a0681070082000d060106810700
-82060d0601068207000d040d81000d020d0100810d0082000d000300010d0400010d0800
-810d0001007f0d060d0200010d0200810d000100010d0300320d82060d060a0681070082
-000d060106810700
-82060d0601068207000d040d81000d7f0d6f0d82060d060a0681070082000d0601068107
-00
-82060d0601068207000d010d02007f0d710d82060d060a0681070082000d060106810700
-
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d7f0d760d82060d060a0681070082000d060106810700
-82060d0601068207000d810d0081000d060d81000d7f0d690d82060d060a068107008200
-0d060106810700
-82060d0601068207000d010d81000d0b0d81000d7f0d640d82060d060a0681070082000d
-060106810700
-82060d0601068207000d010d82000d0081000d010d0200020d0400010d0200820d000d02
-0d0200010d0100810d0081000d7f0d050d0100810d0081000d020d0200010d0100810d00
-81000d020d02002c0d82060d060a0681070082000d060106810700
-82060d0601068207000d010d0100010d81000d020d81000d020d81000d040d85000d000d
-000d820d000d010d81000d810d0081000d820d000d7f0d050d0100010d81000d820d000d
-010d81000d810d0081000d820d000d820d000d010d81000d2a0d82060d060a0681070082
-000d060106810700
-82060d0601068207000d010d81000d010d81000d020d81000d020d81000d040d85000d00
-0d000d010d0300010d81000d010d81000d7f0d050d81000d010d81000d820d000d010d81
-000d820d000d010d81000d810d0003002b0d82060d060a0681070082000d060106810700
-
-82060d0601068207000d010d81000d010d81000d020d81000d020d81000d010d81000d86
-0d000d000d000d820d000d010d81000d820d000d010d81000d7f0d050d81000d010d8100
-0d820d000d010d81000d820d000d010d81000d820d000d2e0d82060d060a068107008200
-0d060106810700
-82060d0601068207000d810d000300020d0400020d0200010d0600810d000400810d0002
-007f0d060d0200810d000100010d0200010d0200810d000100010d03002b0d8106070c07
-0100810d060106810700
-82060d0601068207000d240d81000d7f0d4f0d1000810d060106810700
-82060d0601068207000d230d02007f0d4f0d0e060100810d060106810700
-82060d0601068207000d7f0d760d81060d0b0d81070082000d060106810700
-82060d060106820700047f04760482060d060a0681070082000d060106810700
-82060d060106820700047f04760482060d060a0681070082000d060106810700
-82060d060106820700047f04760482060d060a0681070082000d060106810700
-82060d060106820700047f04760482060d060a0681070082000d060106810700
-82060d060106820700043404810d041304010d7f04290482060d06810600050002068107
-0082000d060106810700
-82060d060106820700041d04810d042b04810d046204810d04430482060d060106040003
-0681070082000d060106810700
-82060d060106820700040204030d0204020d0104010d81040d810d040204030d81040d03
-0d0204010d81040d810d040104020d0204020d0204010d81040d810d040204020d030401
-0d82040d046104040d0104020d81040d010d0104020d330482060d060206020004068107
-0082000d060106810700
-82060d060106820700040104810d040104810d0482040d040104810d0481040d810d0482
-040d0482040d040404810d040504010d0304810d040104810d040204810d040204010d01
-04810d0482040d040104810d0482040d0481040d810d046204810d040404810d04010481
-0d0482040d040104810d04310482060d060306810006040681070082000d060106810700
-
-82060d060106820700040104810d040404810d040104810d0482040d040104810d040104
-020d0204810d040504810d040404030d0304810d040204810d040104810d0481040d030d
-0104810d040104810d046204810d040404850d040d040d0482040d040104810d04310482
-060d060a0681070082000d060106810700
-82060d060106820700040104810d040404810d040104810d0482040d040104810d040404
-810d0482040d040104810d040104810d040304810d040104810d040204810d040204810d
-040104810d0482040d040404810d040104810d046204810d040104810d0486040d040d04
-0d0482040d040104810d04310482060d060a0681070082000d060106810700
-82060d060106820700040204030d0204020d0104020d81040d010d81040d020d0304020d
-0204030d0204050d81040d030d81040d010d81040d010d0104030d0204040d6304020d03
-04830d040d040204020d330482060d060a0681070082000d060106810700
-82060d060106820700047f04760482060d060a0681070082000d060106810700
-82060d060106820700047f0476048106070c070100810d060106810700
-82060d060106820700047f0476041000810d060106810700
-82060d0601068107067f0677061000810d060106810700
-82060d0601067f0d7f0d0b0d0206810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-82060d067f067f061006810700
-8106077f077f0712070000
-7f007f001500
-
-%
-% Compression made this file 6.27% of the uncompressed size.
-%
-
-
-showpage
-
-% stop using temporary dictionary
-end
-
-% restore original state
-origstate restore
-
-%%Trailer
+++ /dev/null
-%!PS-Adobe-2.0 EPSF-2.0
-%%Title: prop2.eps
-%%Creator: XV Version 2.20 Rev: 4/24/92 - by John Bradley
-%%BoundingBox: 167 221 466 500
-%%Pages: 1
-%%DocumentFonts:
-%%EndComments
-%%EndProlog
-
-%%Page: 1 1
-
-% remember original state
-/origstate save def
-
-% build a temporary dictionary
-20 dict begin
-
-% lower left corner
-167 221 translate
-
-% size of image (on paper, in 1/72inch coords)
-299 279 scale
-
-% define 'colorimage' if it isn't defined
-% ('colortogray' and 'mergeprocs' come from xwd2ps
-% via xgrab)
-/colorimage where % do we know about 'colorimage'?
- { pop } % yes: pop off the 'dict' returned
- { % no: define one
- /colortogray { % define an RGB->I function
- /rgbdata exch store % call input 'rgbdata'
- rgbdata length 3 idiv
- /npixls exch store
- /rgbindx 0 store
- /grays npixls string store % str to hold the result
- 0 1 npixls 1 sub {
- grays exch
- rgbdata rgbindx get 20 mul % Red
- rgbdata rgbindx 1 add get 32 mul % Green
- rgbdata rgbindx 2 add get 12 mul % Blue
- add add 64 idiv % I = .5G + .31R + .18B
- put
- /rgbindx rgbindx 3 add store
- } for
- grays
- } bind def
-
- % Utility procedure for colorimage operator.
- % This procedure takes two procedures off the
- % stack and merges them into a single procedure.
-
- /mergeprocs { % def
- dup length
- 3 -1 roll
- dup
- length
- dup
- 5 1 roll
- 3 -1 roll
- add
- array cvx
- dup
- 3 -1 roll
- 0 exch
- putinterval
- dup
- 4 2 roll
- putinterval
- } bind def
-
- /colorimage { % def
- pop pop % remove 'false 3' operands
- {colortogray} mergeprocs
- image
- } bind def
- } ifelse % end of 'false' case
-
-
-
-% define the colormap
-/cmap 42 string def
-
-
-% load up the colormap
-currentfile cmap readhexstring
-000000 bf0000 00bf00 bfbf00 0000bf 00bfbf c0c0c0 808080 ff0000 00ff00
-ffff00 0000ff 00ffff ffffff
-pop pop % lose return values from readhexstring
-
-
-% rlecmapimage expects to have 'w h bits matrix' on stack
-/rlecmapimage {
- /buffer 1 string def
- /rgbval 3 string def
- /block 384 string def
-
- % proc to read a block from file, and return RGB data
- { currentfile buffer readhexstring pop
- /bcount exch 0 get store
- bcount 128 ge
- { % it's a non-run block
- 0 1 bcount 128 sub
- { currentfile buffer readhexstring pop pop
-
- % look up value in color map
- /rgbval cmap buffer 0 get 3 mul 3 getinterval store
-
- % and put it in position i*3 in block
- block exch 3 mul rgbval putinterval
- } for
- block 0 bcount 127 sub 3 mul getinterval
- }
-
- { % else it's a run block
- currentfile buffer readhexstring pop pop
-
- % look up value in colormap
- /rgbval cmap buffer 0 get 3 mul 3 getinterval store
-
- 0 1 bcount { block exch 3 mul rgbval putinterval } for
-
- block 0 bcount 1 add 3 mul getinterval
- } ifelse
- } % end of proc
- false 3 colorimage
-} bind def
-
-
-299 279 8 % dimensions of data
-[299 0 0 -279 0 279] % mapping matrix
-rlecmapimage
-
-7f0003007f072607
-07077f067f0618068100070707
-070781060d7f0d7f0d150d820700070707
-070782060d067f067f061406820700070707
-070782060d067f067f061406820700070707
-070782060d068106077f077f0710070106820700070707
-070782060d068106078207060d820d060783070d0702010203098102077f077e07010682
-0700070707
-070782060d068106078707060b060001020781070283020702098109028102077f074a07
-0e0d81000d0d0d81000781070d0d0d81000781070683060700070707
-070782060d0681060782070806810600820002078507020902070201028109077f074a07
-810d060b068307000d060b068207000782070d060b068207000781070683060700070707
-
-070782060d06810607810706850608000403078207020984090207020981090701070506
-2d070306020701061a0705066a07810d060b068307000d06810600070001068207000782
-070d060b068207000781070683060700070707
-070782060d068106078707060b0604000a07890702090207020702090701070106020701
-061d0701060b07010601070106010701061207010607070106100701065907810d060b06
-8307000d06810600070001068207000782070d0601060100030601000106820700078107
-0683060700070707
-070782060d0681060701070106020001070102860702090207020701070106020701061d
-0701060b070106050701061207010607070106100701065907810d060b068307000d0682
-0600060506810006830607000782070d0602060100010601000206820700078107068306
-0700070707
-070782060d0681060785070d0607060d010d840702000209010982020007010701060207
-010681070601060107030601070406020703060107020681070601068107068206070681
-060703070106050704060207030602070306010702060607010604070306020702060107
-02065807810d060b068307000d06820600060506810006830607000782070d0603060300
-03068207000781070683060700070707
-070782060d06810607070701000602020705060107010601070106010701068107068106
-078107068206070681060781070682060706810607810706810607810706820607068106
-070407030602070206810706820607068106078107068206070681060781070682060706
-81060706070106030701060107010681070682060706820607068106075807810d060b06
-8307000d06820600060506810006830607000782070d0604060100040682070007810706
-83060700070707
-070782060d06810607810705050501000603020701060507010601070106010701068107
-068106078107068206070604068107068106078107068106078107068206070681060707
-070106010701060107010681070604068107060406810706810607060701060307050601
-070106020701065907810d060b068307000d06820600060506810006830607000782070d
-060306030003068207000781070683060700070707
-070782060d0681060781070c010c8205080c830c05030a020a81030a810a070107010605
-070106010701060107010681070681060781070682060706810607030701060107010601
-070106810706810607070701060107010601070106810706810607030701060407010607
-0701060307010606070106010701065907810d060b068307000d06820600060506810006
-830607000782070d06020601000106010002068207000781070683060700070707
-070782060d068106078c070c05070507050c05030a030a840a03000a0701070106050701
-060107010601070106810706810607810706820607068106078107068206070681060781
-070681060701070206050701060107010601070106010701068107068106078107068206
-070681060781070682060706810607060701060307010601070106810706820607068206
-07068106075807810d060106050003068307000d06820600060506810006830607000782
-070d06010601000306010001068207000781070683060700070707
-070782060d0681060782070c08020886070c05030a030a010a82030a0701070106050701
-060207030601070406020703060107010602070106010701060707030602070106010701
-06010703060207030602070106060701060407030602070206020701065807810d060106
-050003068307000d06810600070001068207000782070d060b0682070007810706830607
-00070707
-070782060d0681060782070c080208010c8205030a810a0384030a030a07140701061407
-01067f071c07810d060b068307000d060b068207000782070d060b068207000781070683
-060700070707
-070782060d0681060782070c080308850c05030a030a010a82000a071407010612070206
-7f071d07810d070c0782000d070c0781000782070d070c07810007810706830607000707
-07
-070782060d0681060783070c05080208850c05030a030a810a0382030a077f074a071f00
-01070f0001070106820700070707
-070782060d0681060781070c050c8205030a050a7f077f070106820700070707
-070782060d068106077f077f0710070106820700070707
-070782060d067f067f061406820700070707
-070782060d067f067f061406820700070707
-070782060d0637067f073d07810d061c06820700070707
-070782060d06030616000306160001068107007f003a0082060d06810600150004068207
-00070707
-070782060d06020681000d140d820700068206000d140d8507000607000d7f0d390d8406
-0d06000d140d820700060206820700070707
-070782060d06020682000d06120601078100068306000d061206010784000607000d7f0d
-390d84060d06000d130d01078100060206820700070707
-070782060d06020682000d06120601078100068306000d061206010784000607000d7f0d
-390d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d06120601078100068306000d061206010784000607000d7f0d
-390d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0603068100060606810006030601078100068306000d061206
-010784000607000d010d0100020d0200020d0200020d02007f0d230d84060d06000d810d
-06110601078100060206820700070707
-070782060d06020682000d060306020003060200040601078100068306000d060b068100
-060406010784000607000d810d000100010d0100810d0082000d0082000d0082000d0082
-000d0081000d7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d060406020001060200050601078100068306000d060a060200
-0406010785000607000d000200010d0100810d0082000d0082000d0082000d0082000d00
-81000d7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0605060500060601078100068306000d060906030004060107
-87000607000d000d0081000d810d0082000d0082000d0082000d0082000d0082000d0081
-000d7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0606060300070601078100068306000d060806030005060107
-84000607000d010d0100010d0100810d0082000d0082000d0082000d0082000d0081000d
-7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0606060300070601078100068306000d060306010001060300
-0606010784000607000d010d0100010d0100810d0082000d0082000d0082000d0082000d
-0081000d7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0605060500060601078100068306000d060306060007060107
-84000607000d010d0100010d0100810d0082000d0082000d0082000d0082000d0081000d
-7f0d210d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d060406020001060200050601078100068306000d0604060400
-0806010784000607000d010d0100020d0200020d0200020d02007f0d230d84060d06000d
-810d060306010781060782070607810706040601078100060206820700070707
-070782060d06020682000d060306020003060200040601078100068306000d0605060200
-0906010784000607000d7f0d390d84060d06000d810d0603060107810607820706078107
-06040601078100060206820700070707
-070782060d06020682000d060306010005060100040601078100068306000d0606068100
-060906010784000607000d7f0d390d84060d06000d810d06110601078100060206820700
-070707
-070782060d06020682000d06120601078100068306000d061206010784000607000d7f0d
-390d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d06120601078100068306000d061206010784000607000d7f0d
-390d84060d06000d810d06110601078100060206820700070707
-070782060d06020682000d0714078100068306000d07140784000607000d7f0d390d8506
-0d06000d0714078100060206820700070707
-070782060d06020682000d0714078100068306000d07140784000607000d7f0d390d8406
-0d06000715078100060206820700070707
-070782060d06030616000306160001068207000d7f0d390d82060d068106001500040682
-0700070707
-070782060d0637068107067f063b06810d061c06820700070707
-070782060d0637067f0d3e0d1d06820700070707
-070782060d0601067f077f070e07810d060106820700070707
-070782060d0601068107007f007f000b0082060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d040d0100120d01007f0d150d0200550d82060d0601068207
-00070707
-070782060d0601068207000d030d81000d140d81000d7f0d130d81000d010d81000d530d
-82060d060106820700070707
-070782060d0601068207000d020d0300010d0100810d0081000d010d0200030d0100820d
-000d7f0d130d81000d010d81000d530d82060d060106820700070707
-070782060d0601068207000d030d81000d030d0100030d81000d010d81000d820d000d81
-0d0081000d7f0d130d81000d010d81000d530d82060d060106820700070707
-070782060d0601068207000d030d81000d030d81000d030d0400010d81000d010d81000d
-7f0d130d81000d010d81000d530d82060d060106820700070707
-070782060d0601068207000d030d81000d030d81000d030d81000d040d81000d010d8100
-0d7f0d130d81000d010d81000d530d82060d060106820700070707
-070782060d0601068207000d020d0300010d0300030d0300020d04007f0d140d0200550d
-82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d1c0d0100120d01000e0d81000d6b0d0400090d0100480d82
-060d060106820700070707
-070782060d0601068207000d010d81000d190d81000d120d81000d7c0d81000d820d000d
-090d81000d470d82060d060106820700070707
-070782060d0601068207000d810d000300030d0200010d0100010d0100020d0100810d00
-84000d000d0081000d090d0300010d82000d0081000d020d0200020d0200040d0300020d
-02005e0d83000d000d020d0200040d81000d030d0300020d0200390d82060d0601068207
-00070707
-070782060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d
-820d000d810d0081000d810d0081000d820d000d070d81000d010d81000d810d0081000d
-820d000d820d000d010d81000d020d81000d020d81000d010d81000d820d000d010d8100
-0d5c0d0200020d81000d010d81000d020d81000d020d81000d040d81000d010d81000d37
-0d82060d060106820700070707
-070782060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d
-820d000d010d81000d820d000d010d81000d070d81000d040d81000d010d81000d820d00
-0d010d81000d020d81000d020d81000d040d04005d0d83000d000d020d0300030d81000d
-030d0200020d0400380d82060d060106820700070707
-070782060d0601068207000d010d81000d010d81000d820d000d010d81000d820d000d81
-0d0081000d820d000d010d81000d820d000d010d81000d070d81000d040d81000d010d81
-000d820d000d010d81000d020d81000d020d81000d040d81000d600d81000d030d81000d
-010d81000d020d81000d060d81000d820d000d3b0d82060d060106820700070707
-070782060d0601068207000d020d0200030d0200030d0100810d0081000d810d00020081
-0d000100810d000100080d0300810d000100810d000100010d0200020d0400020d030002
-0d03005c0d0200030d0500810d000300010d0300030d0300380d82060d06010682070007
-0707
-070782060d0601068207000d1a0d81000d7f0d6d0d82060d060106820700070707
-070782060d0601068207000d170d02007f0d6f0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700040304810d047f043204010d4f0482060d0601068207000707
-07
-070782060d060106820700047f043904810d044e0482060d060106820700070707
-070782060d060106820700040104020d0404020d0104010d81040d810d047f042404810d
-044e0482060d060106820700070707
-070782060d060106820700040304810d040204810d040104810d0481040d810d0482040d
-047f041a04040d0304810d044e0482060d060106820700070707
-070782060d060106820700040304810d040304030d0104810d040104810d047f04230481
-0d044e0482060d060106820700070707
-070782060d060106820700040304810d040204810d040104810d0482040d040104810d04
-7f042304810d044e0482060d060106820700070707
-070782060d060106820700040104040d0104080d81040d010d7f042104040d4d0482060d
-060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d060106820700047f047f040a0482060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d810d0081000d060d81000d030d0100040d01007f0d170d02
-00030d03004d0d82060d060106820700070707
-070782060d0601068207000d010d81000d0d0d81000d040d81000d7f0d150d81000d010d
-81000d010d81000d4f0d82060d060106820700070707
-070782060d0601068207000d010d82000d0081000d010d0200050d81000d040d81000d7f
-0d180d81000d020d81000d4f0d82060d060106820700070707
-070782060d0601068207000d010d0100010d81000d020d81000d040d81000d040d81000d
-7f0d170d81000d030d02004e0d82060d060106820700070707
-070782060d0601068207000d010d81000d010d81000d020d81000d040d81000d040d8100
-0d7f0d160d81000d070d81000d4c0d82060d060106820700070707
-070782060d0601068207000d010d81000d010d81000d020d81000d040d81000d040d8100
-0d7f0d150d81000d040d81000d010d81000d4c0d82060d060106820700070707
-070782060d0601068207000d810d000300020d0400010d0400010d04007f0d140d040002
-0d02004e0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d030d81000d0a0d0100050d81000d7f0d6f0d82060d060106
-820700070707
-070782060d0601068207000d110d81000d7f0d760d82060d060106820700070707
-070782060d0601068207000d010d0300010d0100010d0100030d81000d020d0200040d02
-00010d0100810d0081000d7f0d070d0200010d0100810d0081000d020d0200470d82060d
-060106820700070707
-070782060d0601068207000d040d81000d010d81000d010d81000d020d81000d040d8100
-0d020d81000d010d81000d810d0081000d820d000d7f0d050d81000d010d81000d810d00
-81000d820d000d820d000d010d81000d450d82060d060106820700070707
-070782060d0601068207000d040d81000d010d81000d010d81000d020d81000d040d8100
-0d030d0300010d81000d010d81000d7f0d050d81000d010d81000d820d000d010d81000d
-810d000300460d82060d060106820700070707
-070782060d0601068207000d040d81000d010d81000d810d0081000d020d81000d040d81
-000d020d81000d010d81000d820d000d010d81000d7f0d050d81000d010d81000d820d00
-0d010d81000d820d000d490d82060d060106820700070707
-070782060d0601068207000d040d81000d020d0100810d0082000d000300010d0400010d
-0800810d0001007f0d060d0200010d0200810d000100010d0300460d82060d0601068207
-00070707
-070782060d0601068207000d040d81000d7f0d7f0d030d82060d060106820700070707
-070782060d0601068207000d010d02007f0d7f0d050d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d810d0081000d060d81000d7f0d7d0d82060d060106820700
-070707
-070782060d0601068207000d010d81000d0b0d81000d7f0d780d82060d06010682070007
-0707
-070782060d0601068207000d010d82000d0081000d010d0200020d0400010d0200820d00
-0d020d0200010d0100810d0081000d7f0d050d0100810d0081000d020d0200010d010081
-0d0081000d020d0200400d82060d060106820700070707
-070782060d0601068207000d010d0100010d81000d020d81000d020d81000d040d85000d
-000d000d820d000d010d81000d810d0081000d820d000d7f0d050d0100010d81000d820d
-000d010d81000d810d0081000d820d000d820d000d010d81000d3e0d82060d0601068207
-00070707
-070782060d0601068207000d010d81000d010d81000d020d81000d020d81000d040d8500
-0d000d000d010d0300010d81000d010d81000d7f0d050d81000d010d81000d820d000d01
-0d81000d820d000d010d81000d810d0003003f0d82060d060106820700070707
-070782060d0601068207000d010d81000d010d81000d020d81000d020d81000d010d8100
-0d860d000d000d000d820d000d010d81000d820d000d010d81000d7f0d050d81000d010d
-81000d820d000d010d81000d820d000d010d81000d820d000d420d82060d060106820700
-070707
-070782060d0601068207000d810d000300020d0400020d0200010d0600810d000400810d
-0002007f0d060d0200810d000100010d0200010d0200810d000100010d03003f0d82060d
-060106820700070707
-070782060d0601068207000d240d81000d7f0d630d82060d060106820700070707
-070782060d0601068207000d230d02007f0d630d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d340d81000d130d01007f0d3d0d82060d0601068207000707
-07
-070782060d0601068207000d1d0d81000d2b0d81000d620d81000d570d82060d06010682
-0700070707
-070782060d0601068207000d020d0300020d0200010d0100810d0081000d020d0300810d
-000300020d0100810d0081000d010d0200020d0200020d0100810d0081000d020d020003
-0d0100820d000d610d0400010d0200810d000100010d0200470d82060d06010682070007
-0707
-070782060d0601068207000d010d81000d010d81000d820d000d010d81000d810d008100
-0d820d000d820d000d040d81000d050d0100030d81000d010d81000d020d81000d020d01
-00010d81000d820d000d010d81000d820d000d810d0081000d620d81000d040d81000d01
-0d81000d820d000d010d81000d450d82060d060106820700070707
-070782060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d
-010d0200020d81000d050d81000d040d0300030d81000d020d81000d010d81000d810d00
-0300010d81000d010d81000d620d81000d040d85000d000d000d820d000d010d81000d45
-0d82060d060106820700070707
-070782060d0601068207000d010d81000d040d81000d010d81000d820d000d010d81000d
-040d81000d820d000d010d81000d010d81000d030d81000d010d81000d020d81000d020d
-81000d010d81000d820d000d040d81000d010d81000d620d81000d010d81000d860d000d
-000d000d820d000d010d81000d450d82060d060106820700070707
-070782060d0601068207000d020d0300020d0200010d0200810d000100810d000200030d
-0200020d0300020d0500810d000300810d000100810d000100010d0300020d0400630d02
-00030d83000d000d020d0200470d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-070782060d0601068207000d7f0d7f0d0a0d82060d060106820700070707
-7f077f0726078100070107
-03077f0d7f0d210d820700070107
-0307820d06077f077f071c07840d060700070107
-0307830d0607047f047f041c0483060700070107
-0307830d0607047f047f041c0483060700070107
-0307830d0607047f047f040a040e0d8100048404060700070107
-0307830d0607047f047f040a04810d060b06820700048404060700070107
-0307830d06070481040d040d3a04010d7f044604810d060b068207000484040607000701
-07
-0307830d06070481040d810d040104010d1d04010d1904010d7f044604810d0601060107
-030601070106820700048404060700070107
-0307830d06070481040d810d040104010d1d04010d1904010d7f044604810d0602060107
-01060107010d83060700048404060700070107
-0307830d06070481040d810d040104010d81040d010d0104030d0104040d0204030d0104
-020d81040d010d81040d820d040d810d040304010d0104010d0104030d0104010d81040d
-810d0481040d810d0481040d020d0604030d0104020d81040d010d0104030d0104020d7f
-041a04810d0603060307010d0106820700048404060700070107
-0307830d06070481040d040d0104010d0104010d0104010d81040d810d0481040d820d04
-0d810d0481040d820d040d810d0481040d810d0481040d820d040d810d040304010d0104
-010d0404010d81040d820d040d810d0481040d820d040d810d0481040d810d040304010d
-0104010d81040d810d0481040d810d0481040d810d0481040d820d040d810d047f041a04
-810d0604060107010d0206820700048404060700070107
-0307830d06070481040d810d040404010d0104010d0104010d81040d810d0481040d820d
-040d040d81040d810d0481040d810d0481040d820d040d810d040404030d0204040d8104
-0d820d040d810d0481040d820d040d040d0404050d81040d810d0481040d810d0481040d
-810d0481040d820d040d810d047f041a04810d0603060307030682070004840406070007
-0107
-0307830d06070481040d810d040404010d0104010d0104010d81040d810d0481040d820d
-040d810d040304010d0104010d0104010d81040d810d040404030d0104010d0104010d81
-040d820d040d810d0481040d820d040d810d040704010d0404010d0104010d0104010d01
-04010d81040d810d047f041a04810d0602060107010d0107020682070004840406070007
-0107
-0307830d06070481040d810d040404010d0104010d0104010d81040d810d0481040d820d
-040d810d0481040d820d040d810d0481040d810d040104020d0704010d0204010d010401
-0d81040d820d040d820d040d010d81040d810d0481040d810d040304010d0104010d8104
-0d810d0481040d810d0481040d810d0481040d820d040d810d047f041a04810d06010601
-07010d010601070106820700048404060700070107
-0307830d06070481040d810d040404010d0204030d0104040d0204030d0104010d020401
-0d0104010d0804010d0304040d81040d810d0481040d030d0104030d0604030d0104010d
-0104010d0204030d0104010d7f041b04810d060206010d0306010d830607000484040607
-00070107
-0307830d0607041304010d1404010d7f045d04810d060b06820700048404060700070107
-
-0307830d0607041304010d1204020d7f045e04810d070c078100048404060700070107
-0307830d0607047f047f040a040f00010483060700070107
-0307830d0607047f047f041c0483060700070107
-0307830d0607047f047f041c0483060700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d06170602037f067f060406820700070107
-0307810d06160681030a830a0600067f067f060206820700070107
-0307810d06150681030a020a83060007067f067f0683060700070107
-0307810d06150681030a030a8100078107067f067f06820700070107
-0307810d06140681030a040a820600078107067f067e06820700070107
-0307810d06140681030a050a8100078107067f067e06820700070107
-0307810d06130681030a060a820600078107067f067d06820700070107
-0307810d06130681030a070a8100078107067f067d06820700070107
-0307810d06120681030a080a820600078107067f067c06820700070107
-0307810d06120681030a010a810600010081060a010a8100078107067f067c0682070007
-0107
-0307810d06110681030a020a0400020a820600078107067f067b06820700070107
-0307810d06110681030a020a0400030a8100078107061606810006030681000605068100
-0627068100061b0681000620068100062c06040001060200140681000602060400010602
-0001068100060a06820700070107
-0307810d06100681030a030a0400030a8206000781070615068100060306810006050681
-000621068100060306810006230681000618068100060906810006200681000603068100
-060106810006120681000602068100060306810006010683000600060a06820700070107
-
-0307810d06100681030a030a0400040a8100078107061606810006010681000606068100
-062106810006030681000623068100061806810006090681000620068100060306810006
-0106810006120681000602068100060306810006010683000600060a06820700070107
-0307810d060f0681030a040a0400040a8206000781070615068100060106810006010602
-000106830006000601068100068106000100040602008106008100068206000601068100
-068106008100068106008100060206030002060200050602000106820006008100060306
-840006000600810006810600810006810600010002060300010602000106010003060300
-020602000106010082060006820600068206000681060001000206020001068200060081
-000606060300010681000601068100060306020001068200060081000601060300030603
-000106810006010683000600060a06820700070107
-0307810d060f0681030a040a810300010081030a040a8100078107061506810006010681
-000604068500060006000601068300060006010681000602068100068206000684060006
-000601068300060006840600060006030681000601068300060006010681000606068200
-060081000682060006020682000600810006840600060006820600060106830006000601
-068300060006010683000600060306810006010683000600060106830006000682060006
-820600068406000600060106830006000601068200060081000682060006050681000601
-068300060006010681000606068200060081000684060006000601068100060206810006
-01068300060006010683000600060a06820700070107
-0307810d060e0681030a050a810600010081060a040a8206000781070615068300060006
-020603008406000600060106820006000300030681000682060006840600060006010681
-000682060006010681000603068100060106820006000300040603008206000601068100
-060206830006000601068300060006810600030082060006010682000600030082060006
-030681000601068200060003008206000689060006000600060006000300810600030082
-060006010681000602060100040683000600060106810006030603008206000601068300
-060006010681000606068300060006010683000600060a06820700070107
-0307810d060e0681030a060a0200070a8100078107061506830006000601068100060106
-850006000600060106830006000606068100068206000684060006000601068100060106
-810006820600060306810006010683000600060606810006010683000600060106810006
-020683000600060106830006000682060006030681000601068300060006030681000603
-068100060106830006000603068100068a06000600060006000600060306810006030681
-000601068100060906830006000601068100060206810006010683000600060106830006
-0006010681000606068300060006010683000600060a06820700070107
-0307810d060d0681030a070a830300030a060a8206000781070615068100060206810006
-010685000600060006810600830006000601068100060206810006820600068406000600
-068106008300060006840600060006030681000601068300060006010681000602068100
-060106830006000601068100060206830006000601068300060006820600060106830006
-000601068300060006010683000600060306810006010683000600060106830006000601
-068100060106810006820600060106830006000601068300060006010681000605068100
-060106830006000601068100060206810006010683000600060106830006000601068100
-0602068100060106830006000601068100060c06820700070107
-0307810d060d0681030a070a830600060a070a8100078107061506810006030603008206
-000681060083000600068106000100040681000682060006820600068106008300060006
-810600810006010681000602060300020602000506030082060006010681000602068300
-060006010681000682060006810600010002060300010602000106810006030603000206
-020002068100068206000601068100060106020002060200010681000601068100060606
-020002060200050603008206000601068100068106000200040602000206020001068100
-060a06820700070107
-0307810d060c0681030a090a81000a080a820600078107067c0681000677068207000701
-07
-0307810d060c0681030a150a810007810706780603007906820700070107
-0307810d060b0681030a090a8106008200060a070a820600078107067f06750682070007
-0107
-0307810d060b0681030a090a0300090a8100078107067f067506820700070107
-0307810d060a0681030a0a0a0300090a820600078107067f067406820700070107
-0307810d060a0681030a0a0a8106008200060a090a8100078107067f0674068207000701
-07
-0307810d060a0681030a190a81000701077f067406820700070107
-0307810d060a0681030a180a8206000701077f067406820700070107
-0307810d060b0681030a160a8206000702077f067406820700070107
-0307810d060c06810300160004077f067406820700070107
-0307810d060e061a077f067506820700070107
-0307810d060f0618077f067606820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d066b0648006a06820700070107
-0307810d066a064a006906820700070107
-0307810d066a060100450d8107008100066806820700070107
-0307810d066a060100440d010701006906820700070107
-0307810d066a060100010d18069100060006000600060006000600060006000617060107
-01006906820700070107
-0307810d066a060100010d4206010701006906820700070107
-0307810d066a060100010d18068100060d068100061706010701006906820700070107
-0307810d066a060100010d1b060300020681000601068100061906010701006906820700
-070107
-0307810d066a060100010d18068300060006020681000682060006820600068206000617
-06010701006906820700070107
-0307810d066a060100010d1a0681000602068100068406000600061b0601070100690682
-0700070107
-0307810d066a060100010d18068300060006020681000681060081000602068100061706
-010701006906820700070107
-0307810d066a060100010d1a0681000602068100068106008100061c0601070100690682
-0700070107
-0307810d066a060100010d18068300060006020681000684060006000601068100061706
-010701006906820700070107
-0307810d066a060100010d1a06810006020681000682060006820600061a060107010069
-06820700070107
-0307810d066a060100010d18068300060006020681000682060006010683000600061706
-010701006906820700070107
-0307810d066a060100010d1b060300020681000602068100061806010701006906820700
-070107
-0307810d066a060100010d18068100060d068100061706010701006906820700070107
-0307810d066a060100010d4206010701006906820700070107
-0307810d066a060100010d18069100060006000600060006000600060006000617060107
-01006906820700070107
-0307810d066a060100810d07440701006906820700070107
-0307810d066a060100460701006906820700070107
-0307810d066a064a006906820700070107
-0307810d066b0648006a06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-0307810d067f067f061f06820700070107
-7f077f0726078100070107
-02077f007f0024000207
-7f077f072a07
-7f077f072a07
-7f077f072a07
-7f077f072a07
-7f077f072a07
-7f077f072a07
-
-%
-% Compression made this file 5.68% of the uncompressed size.
-%
-
-
-showpage
-
-% stop using temporary dictionary
-end
-
-% restore original state
-origstate restore
-
-%%Trailer
+++ /dev/null
-\section{\class{wxBoolFormValidator}}\label{wxboolformvalidator}
-
-This class validates a boolean value for a \helpref{form view}{wxpropertyformview}.
-The associated control must be a wxCheckBox.
-
-\wxheading{See also}
-
-\helpref{Property validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxBoolFormValidator::wxBoolFormValidator}
-
-\func{void}{wxBoolFormValidator}{\param{long }{flags=0}}
-
-Constructor.
-
+++ /dev/null
-\section{\class{wxBoolListValidator}}\label{wxboollistvalidator}
-
-This class validates a boolean value for a \helpref{property list view}{wxpropertylistview}.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxBoolListValidator::wxBoolListValidator}
-
-\func{void}{wxBoolListValidator}{\param{long }{flags=0}}
-
-Constructor.
-
+++ /dev/null
-% Deprecated property classes
-\input propbfva.tex
-\input propblva.tex
-\input propflva.tex
-\input propifva.tex
-\input propilva.tex
-\input proplosv.tex
-\input property.tex
-\input propford.tex
-\input propforf.tex
-\input propforp.tex
-\input propforv.tex
-\input propfovi.tex
-\input proplisd.tex
-\input proplisf.tex
-\input proplisp.tex
-\input propliva.tex
-\input proplstv.tex
-\input propsht.tex
-\input propvald.tex
-\input propregv.tex
-\input propval.tex
-\input propview.tex
-\input proprfva.tex
-\input proprlva.tex
-\input propstfv.tex
-\input propslv.tex
-
+++ /dev/null
-\section{\class{wxProperty}}\label{wxproperty}
-
-The {\bf wxProperty} class represents a property, with a \helpref{wxPropertyValue}{wxpropertyvalue}\rtfsp
-containing the actual value, a name a role, an optional validator, and
-an optional associated window.
-
-A property might correspond to an actual C++ data member, or it
-might correspond to a conceptual property, such as the width of a window.
-There is no explicit data member {\it wxWindow::width}, but it may be convenient
-to invent such a property for the purposes of editing attributes of the window.
-The properties in the property sheet can be mapped to ``reality" by
-whatever means (in this case by calling wxWindow::SetSize when the user has
-finished editing the property sheet).
-
-A validator may be associated with the property in order to ensure that this and
-only this validator will be used for editing and validating the property.
-An alternative method is to use the {\it role} parameter to specify what kind
-of validator would be appropriate; for example, specifying ``filename" for the role
-would allow the property view to find an appropriate validator at edit time.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxProperty::wxProperty}
-
-\func{void}{wxProperty}{\void}
-
-\func{void}{wxProperty}{\param{wxProperty\& }{prop}}
-
-\func{void}{wxProperty}{\param{wxString}{ name}, \param{wxString}{ role}, \param{wxPropertyValidator *}{validator=NULL}}
-
-\func{void}{wxProperty}{\param{wxString}{ name}, \param{const wxPropertyValue\&}{ val}, \param{wxString}{ role}, \param{wxPropertyValidator *}{validator=NULL}}
-
-Constructors.
-
-\membersection{wxProperty::\destruct{wxProperty}}
-
-\func{void}{\destruct{wxProperty}}{\void}
-
-Destructor. Destroys the wxPropertyValue, and the property validator if there is one. However, if the
-actual C++ value in the wxPropertyValue is a pointer, the data in that variable is not destroyed.
-
-\membersection{wxProperty::GetValue}
-
-\func{wxPropertyValue\&}{GetValue}{\void}
-
-Returns a reference to the property value.
-
-\membersection{wxProperty::GetValidator}
-
-\func{wxPropertyValidator *}{GetValidator}{\void}
-
-Returns a pointer to the associated property validator (if any).
-
-\membersection{wxProperty::GetName}
-
-\func{wxString\&}{GetName}{\void}
-
-Returns the name of the property.
-
-\membersection{wxProperty::GetRole}
-
-\func{wxRole\&}{GetRole}{\void}
-
-Returns the role of the property, to be used when choosing an appropriate validator.
-
-\membersection{wxProperty::GetWindow}
-
-\func{wxWindow *}{GetWindow}{\void}
-
-Returns the window associated with the property (if any).
-
-\membersection{wxProperty::SetValue}
-
-\func{void}{SetValue}{\param{wxPropertyValue\&}{ val}}
-
-Sets the value of the property.
-
-\membersection{wxProperty::SetName}
-
-\func{void}{SetName}{\param{wxString\&}{ name}}
-
-Sets the name of the property.
-
-\membersection{wxProperty::SetRole}
-
-\func{void}{SetRole}{\param{wxString\&}{ role}}
-
-Sets the role of the property.
-
-\membersection{wxProperty::SetValidator}
-
-\func{void}{SetValidator}{\param{wxPropertyValidator *}{validator}}
-
-Sets the validator: this will be deleted when the property is deleted.
-
-\membersection{wxProperty::SetWindow}
-
-\func{void}{SetWindow}{\param{wxWindow *}{win}}
-
-Sets the window associated with the property.
-
-\membersection{wxProperty::operator $=$}
-
-\func{void}{operator $=$}{\param{const wxPropertyValue\&}{ val}}
-
-Assignment operator.
-
+++ /dev/null
-\section{\class{wxFilenameListValidator}}\label{wxfilenamelistvalidator}
-
-This class validates a filename for a \helpref{property list view}{wxpropertylistview}, allowing the user to edit it textually and also popping up
-a file selector in ``detailed editing" mode.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxFilenameListValidator::wxFilenameListValidator}
-
-\func{void}{wxFilenameListValidator}{\param{wxString }{message = ``Select a file"}, \param{wxString }{wildcard = ``*.*"},
- \param{long}{ flags=0}}
-
-Constructor. Supply an optional message and wildcard.
-
+++ /dev/null
-\section{\class{wxPropertyFormDialog}}\label{wxpropertyformdialog}
-
-The {\bf wxPropertyFormDialog} class is a prepackaged dialog which can
-be used for viewing a form property sheet. Pass a property form view object, and the dialog
-will pass OnClose and OnDefaultAction listbox messages to the view class for
-processing.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyFormDialog::wxPropertyFormDialog}
-
-\func{void}{wxPropertyFormDialog}{\param{wxPropertyFormView *}{view}, \param{wxWindow *}{parent}, \param{char *}{title},
- \param{bool}{ modal=false}, \param{int}{ x=-1}, \param{int}{ y=-1}, \param{int}{ width=-1}, \param{int}{height=-1},
- \param{long}{ style=wxDEFAULT\_DIALOG\_STYLE}, \param{char *}{name=``dialogBox"}}
-
-Constructor.
-
-\membersection{wxPropertyFormDialog::\destruct{wxPropertyFormDialog}}
-
-\func{void}{\destruct{wxPropertyFormDialog}}{\void}
-
-Destructor.
-
+++ /dev/null
-\section{\class{wxPropertyFormFrame}}\label{wxpropertyformframe}
-
-The {\bf wxPropertyFormFrame} class is a prepackaged frame which can
-be used for viewing a property form. Pass a property form view object, and the frame
-will pass OnClose messages to the view class for processing.
-
-Call Initialize to create the panel and associate the view; override OnCreatePanel
-if you wish to use a panel class other than the default wxPropertyFormPanel.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyFormFrame::wxPropertyFormFrame}
-
-\func{void}{wxPropertyFormFrame}{\param{wxPropertyFormView *}{view}, \param{wxFrame *}{parent}, \param{char *}{title},
- \param{int}{ x=-1}, \param{int}{ y=-1}, \param{int}{ width=-1}, \param{int}{height=-1},
- \param{long}{ style=wxSDI $\|$ wxDEFAULT\_FRAME}, \param{char *}{name=``frame"}}
-
-Constructor.
-
-\membersection{wxPropertyFormFrame::\destruct{wxPropertyFormFrame}}
-
-\func{void}{\destruct{wxPropertyFormFrame}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyFormFrame::GetPropertyPanel}
-
-\func{wxPanel *}{GetPropertyPanel}{\void}
-
-Returns the panel associated with the frame.
-
-\membersection{wxPropertyFormFrame::Initialize}
-
-\func{bool}{Initialize}{\void}
-
-Must be called to create the panel and associate the view with the panel and frame.
-
-\membersection{wxPropertyFormFrame::OnCreatePanel}
-
-\func{wxPanel *}{OnCreatePanel}{\param{wxFrame *}{parent}, \param{wxPropertyFormView *}{view}}
-
-Creates a panel. Override this to create a panel type other than wxPropertyFormPanel.
-
+++ /dev/null
-\section{\class{wxPropertyFormPanel}}\label{wxpropertyformpanel}
-
-The {\bf wxPropertyFormPanel} class is a prepackaged panel which can
-be used for viewing a property form. Pass a property form view object, and the panel
-will pass OnDefaultAction listbox messages to the view class for
-processing.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyFormPanel::wxPropertyFormPanel}
-
-\func{void}{wxPropertyFormPanel}{\param{wxPropertyFormView *}{view}, \param{wxWindow *}{parent},
- \param{int}{ x=-1}, \param{int}{ y=-1}, \param{int}{ width=-1}, \param{int}{height=-1},
- \param{long}{ style=0}, \param{char *}{name=``panel"}}
-
-Constructor.
-
-\membersection{wxPropertyFormPanel::\destruct{wxPropertyFormPanel}}
-
-\func{void}{\destruct{wxPropertyFormPanel}}{\void}
-
-Destructor.
-
+++ /dev/null
-\section{\class{wxPropertyFormValidator}}\label{wxpropertyformvalidator}
-
-The {\bf wxPropertyFormValidator} class defines a base class for form validators. By overriding virtual functions,
-the programmer can create custom behaviour for kinds of property.
-
-\wxheading{See also}
-
-\helpref{wxPropertyFormValidator overview}{wxpropertyformvalidatoroverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyFormValidator::wxPropertyFormValidator}
-
-\func{void}{wxPropertyFormValidator}{\param{long}{ flags = 0}}
-
-Constructor.
-
-\membersection{wxPropertyFormValidator::\destruct{wxPropertyFormValidator}}
-
-\func{void}{\destruct{wxPropertyFormValidator}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyFormValidator::OnCommand}
-
-\func{bool}{OnCommand}{\param{wxProperty *}{property}, \param{wxPropertyFormView *}{view},
- \param{wxWindow *}{parentWindow}, \param{wxCommandEvent\& }{event}}
-
-Called when the control corresponding to the property receives a command (if not intercepted
-by a callback associated with the actual control).
-
-\membersection{wxPropertyFormValidator::OnCheckValue}
-
-\func{bool}{OnCheckValue}{\param{wxProperty *}{property}, \param{wxPropertyFormView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the view checks the property value. The value checked by this validator should be taken from the
-panel item corresponding to the property.
-
-\membersection{wxPropertyFormValidator::OnDisplayValue}
-
-\func{bool}{OnDisplayValue}{\param{wxProperty *}{property}, \param{wxPropertyFormView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Should display the property value in the appropriate control.
-
-\membersection{wxPropertyFormValidator::OnDoubleClick}
-
-\func{bool}{OnDoubleClick}{\param{wxProperty *}{property}, \param{wxPropertyFormView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the control corresponding to the property is double clicked (listboxes only).
-
-\membersection{wxPropertyFormValidator::OnRetrieveValue}
-
-\func{bool}{OnRetrieveValue}{\param{wxProperty *}{property}, \param{wxPropertyFormView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Should do the transfer from the property editing area to the property itself.
-
+++ /dev/null
-\section{\class{wxPropertyFormView}}\label{wxpropertyformview}
-
-The {\bf wxPropertyFormView} class shows a wxPropertySheet as a view onto a panel or dialog
-box which has already been created.
-
-\wxheading{See also}
-
-\helpref{wxPropertyFormView overview}{wxpropertyformviewoverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyFormView::wxPropertyFormView}
-
-\func{void}{wxPropertyFormView}{\param{long}{ flags = 0}}
-
-Constructor.
-
-\membersection{wxPropertyFormView::\destruct{wxPropertyFormView}}
-
-\func{void}{\destruct{wxPropertyFormView}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyFormView::AssociateNames}\label{wxpropertyformviewassociatenames}
-
-\func{void}{AssociateNames}{\void}
-
-Associates the properties with the controls on the panel. For each panel item, if the
-panel item name is the same as a property name, the two objects will be associated.
-This function should be called manually since the programmer may wish to do the
-association manually.
-
-\membersection{wxPropertyFormView::Check}\label{wxpropertyformviewcheck}
-
-\func{bool}{Check}{\void}
-
-Checks all properties by calling the appropriate validators; returns false if a validation failed.
-
-\membersection{wxPropertyFormView::GetPanel}\label{wxpropertyformviewgetpanel}
-
-\func{wxPanel *}{GetPanel}{\void}
-
-Returns the panel associated with the view.
-
-\membersection{wxPropertyFormView::GetManagedWindow}\label{wxpropertyformviewgetmanagedwindow}
-
-\func{wxWindow *}{GetManagedWindow}{\void}
-
-Returns the managed window (a frame or dialog) associated with the view.
-
-\membersection{wxPropertyFormView::OnOk}\label{wxpropertyformviewonok}
-
-\func{void}{OnOk}{\void}
-
-Virtual function that will be called when the OK button on the physical window is pressed.
-By default, checks and updates the form values, closes and deletes the frame or dialog, then deletes the view.
-
-\membersection{wxPropertyFormView::OnCancel}\label{wxpropertyformviewoncancel}
-
-\func{void}{OnCancel}{\void}
-
-Virtual function that will be called when the Cancel button on the physical window is pressed.
-By default, closes and deletes the frame or dialog, then deletes the view.
-
-\membersection{wxPropertyFormView::OnHelp}\label{wxpropertyformviewonhelp}
-
-\func{void}{OnHelp}{\void}
-
-Virtual function that will be called when the Help button on the physical window is pressed.
-This needs to be overridden by the application for anything interesting to happen.
-
-\membersection{wxPropertyFormView::OnRevert}\label{wxpropertyformviewonrevert}
-
-\func{void}{OnRevert}{\void}
-
-Virtual function that will be called when the Revert button on the physical window is pressed.
-By default transfers the wxProperty values to the panel items (in effect
-undoing any unsaved changes in the items).
-
-\membersection{wxPropertyFormView::OnUpdate}\label{wxpropertyformviewonupdate}
-
-\func{void}{OnUpdate}{\void}
-
-Virtual function that will be called when the Update button on the physical window is pressed.
-By defaults transfers the displayed values to the wxProperty objects.
-
-\membersection{wxPropertyFormView::SetManagedWindow}\label{wxpropertyformviewsetmanagedwindow}
-
-\func{void}{SetManagedWindow}{\param{wxWindow *}{win}}
-
-Sets the managed window (a frame or dialog) associated with the view.
-
-\membersection{wxPropertyFormView::TransferToDialog}\label{wxpropertyformviewtransfertodialog}
-
-\func{bool}{TransferToDialog}{\void}
-
-Transfers property values to the controls in the dialog.
-
-\membersection{wxPropertyFormView::TransferToPropertySheet}\label{wxpropertyformviewtransfertopropertysheet}
-
-\func{bool}{TransferToPropertySheet}{\void}
-
-Transfers property values from the controls in the dialog to the property sheet.
-
+++ /dev/null
-\section{\class{wxIntegerFormValidator}}\label{wxintegerformvalidator}
-
-This class validates a range of integer values for a form view. The associated control must be a wxTextCtrl
-or wxSlider.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxIntegerFormValidator::wxIntegerFormValidator}
-
-\func{void}{wxIntegerFormValidator}{\param{long }{min=0}, \param{long }{max=0},
- \param{long}{ flags=0}}
-
-Constructor. Assigning zero to minimum and maximum values indicates that there is no range to check.
-
+++ /dev/null
-\section{\class{wxIntegerListValidator}}\label{wxintegerlistvalidator}
-
-This class validates a range of integer values for a list view.
-
-\wxheading{See also}
-
-\overview{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxIntegerListValidator::wxIntegerListValidator}
-
-\func{void}{wxIntegerListValidator}{\param{long }{min=0}, \param{long }{max=0},
- \param{long}{ flags=wxPROP\_ALLOW\_TEXT\_EDITING}}
-
-Constructor. Assigning zero to minimum and maximum values indicates that there is no range to check.
-
+++ /dev/null
-\section{\class{wxPropertyListDialog}}\label{wxpropertylistdialog}
-
-The {\bf wxPropertyListDialog} class is a prepackaged dialog which can
-be used for viewing a property list. Pass a property list view object, and the dialog
-will pass OnClose and OnDefaultAction listbox messages to the view class for
-processing.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyListDialog::wxPropertyListDialog}
-
-\func{void}{wxPropertyListDialog}{\param{wxPropertyListView *}{view}, \param{wxWindow *}{parent}, \param{char *}{title},
- \param{bool}{ modal=false}, \param{int}{ x=-1}, \param{int}{ y=-1}, \param{int}{ width=-1}, \param{int}{height=-1},
- \param{long}{ style=wxDEFAULT\_DIALOG\_STYLE}, \param{char *}{name=``dialogBox"}}
-
-Constructor.
-
-\membersection{wxPropertyListDialog::\destruct{wxPropertyListDialog}}
-
-\func{void}{\destruct{wxPropertyListDialog}}{\void}
-
-Destructor.
-
+++ /dev/null
-\section{\class{wxPropertyListFrame}}\label{wxpropertylistframe}
-
-The {\bf wxPropertyListFrame} class is a prepackaged frame which can
-be used for viewing a property list. Pass a property list view object, and the frame
-will pass OnClose messages to the view class for processing.
-
-Call Initialize to create the panel and associate the view; override OnCreatePanel
-if you wish to use a panel class other than the default wxPropertyListPanel.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyListFrame::wxPropertyListFrame}
-
-\func{void}{wxPropertyListFrame}{\param{wxPropertyListView *}{view}, \param{wxFrame *}{parent}, \param{char *}{title},
- \param{int}{ x=-1}, \param{int}{ y=-1}, \param{int}{ width=-1}, \param{int}{height=-1},
- \param{long}{ style=wxSDI $\|$ wxDEFAULT\_FRAME}, \param{char *}{name=``frame"}}
-
-Constructor.
-
-\membersection{wxPropertyListFrame::\destruct{wxPropertyListFrame}}
-
-\func{void}{\destruct{wxPropertyListFrame}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyListFrame::GetPropertyPanel}
-
-\func{wxPanel *}{GetPropertyPanel}{\void}
-
-Returns the panel associated with the frame.
-
-\membersection{wxPropertyListFrame::Initialize}
-
-\func{bool}{Initialize}{\void}
-
-Must be called to create the panel and associate the view with the panel and frame.
-
-\membersection{wxPropertyListFrame::OnCreatePanel}
-
-\func{wxPanel *}{OnCreatePanel}{\param{wxFrame *}{parent}, \param{wxPropertyListView *}{view}}
-
-Creates a panel. Override this to create a panel type other than wxPropertyListPanel.
-
+++ /dev/null
-\section{\class{wxPropertyListPanel}}\label{wxpropertylistpanel}
-
-The {\bf wxPropertyListPanel} class is a prepackaged panel which can
-be used for viewing a property list. Pass a property list view object, and the panel
-will pass OnDefaultAction listbox messages to the view class for
-processing.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyListPanel::wxPropertyListPanel}
-
-\func{void}{wxPropertyListPanel}{\param{wxPropertyListView *}{view}, \param{wxWindow *}{parent},
- \param{const wxPoint&}{ pos = wxDefaultPosition},
- \param{const wxSize&}{ size = wxDefaultSize},
- \param{long}{ style=0}, \param{char *}{name=``panel"}}
-
-Constructor.
-
-\membersection{wxPropertyListPanel::\destruct{wxPropertyListPanel}}
-
-\func{void}{\destruct{wxPropertyListPanel}}{\void}
-
-Destructor.
-
+++ /dev/null
-\chapter{Property sheet classes}\label{proplist}
-
-\section{Introduction}\label{proplistintro}
-
-The Property Sheet Classes help the programmer to specify complex dialogs and
-their relationship with their associated data. By specifying data as a
-wxPropertySheet containing wxProperty objects, the programmer can use
-a range of available or custom wxPropertyView classes to allow the user to
-edit this data. Classes derived from wxPropertyView act as mediators between the
-wxPropertySheet and the actual window (and associated panel items).
-
-For example, the wxPropertyListView is a kind of wxPropertyView which displays
-data in a Visual Basic-style property list (see \helpref{the next section}{proplistappearance} for
-screen shots). This is a listbox containing names and values, with
-an edit control and other optional controls via which the user edits the selected
-data item.
-
-wxPropertyFormView is another kind of wxPropertyView which mediates between
-the data and a panel or dialog box which has already been created. This makes it a contender for
-the replacement of wxForm, since programmer-controlled layout is going to be much more
-satisfactory. If automatic layout is desired, then wxPropertyListView could be used instead.
-
-The main intention of this class library was to provide property {\it list} behaviour, but
-it has been generalised as much as possible so that the concept of a property sheet and its viewers
-can reduce programming effort in a range of user interface tasks.
-
-For further details on the classes and how they are used, please see \helpref{Property classes overview}{proplistpropertyoverview}.
-
-\subsection{The appearance and behaviour of a property list view}\label{proplistappearance}
-
-The property list, as seen in an increasing number of development tools
-such as Visual Basic and Delphi, is a convenient and compact method for
-displaying and editing a number of items without the need for one
-control per item, and without the need for designing a special form. The
-controls are as follows:
-
-\begin{itemize}\itemsep=0pt
-\item A listbox showing the properties and their current values, which has double-click
-properties dependent on the nature of the current property;
-\item a text editing area at the top of the display, allowing the user to edit
-the currently selected property if appropriate;
-\item `confirm' and `cancel' buttons to confirm or cancel an edit (for the property, not the
-whole sheet);
-\item an optional list that appears when the user can make a choice from several known possible values;
-\item a small Edit button to invoke `detailed editing' (perhaps showing or hiding the above value list, or
-maybe invoking a common dialog);
-\item optional OK/Close, Cancel and Help buttons for the whole dialog.
-\end{itemize}
-
-The concept of `detailed editing' versus quick editing gives the user a choice
-of editing mode, so novice and expert behaviour can be catered for, or the user can just
-use what he feels comfortable with.
-
-Behaviour alters depending on the kind of property being edited. For example, a boolean value has
-the following behaviour:
-
-\begin{itemize}\itemsep=0pt
-\item Double-clicking on the item toggles between true and false.
-\item Showing the value list enables the user to select true or false.
-\item The user may be able to type in the word true or false, or the edit control
-may be read-only to disallow this since it is error-prone.
-\end{itemize}
-
-A list of strings may pop up a dialog for editing them, a simple string just allows text editing,
-double-clicking a colour property may show a colour selector, double-clicking on a filename property may
-show a file selector (in addition to being able to type in the name in the edit control), etc.
-
-Note that the `type' of property, such as string or integer, does not
-necessarily determine the behaviour of the property. The programmer has
-to be able to specify different behaviours for the same type, depending
-on the meaning of the property. For example, a colour and a filename may
-both be strings, but their editing behaviour should be different. This
-is why objects of type wxPropertyValidator need to be used, to define
-behaviour for a given class of properties or even specific property
-name. Objects of class wxPropertyView contain a list of property
-registries, which enable reuse of bunches of these validators in
-different circumstances. Or a wxProperty can be explicitly set to use a
-particular validator object.
-
-The following screen shot of the property classes test program shows the
-user editing a string, which is constrained to be one of three possible
-values.
-
-\helponly{\image{}{prop1.bmp}}
-
-The second picture shows the user having entered a integer that
-was outside the range specified to the validator. Note that in this picture,
-the value list is hidden because it is not used when editing an integer.
-
-\helponly{\image{}{prop2.bmp}}
-
-\section{Headers}\label{proplistfiles}
-
-The property class library comprises the following files:
-
-\begin{itemize}\itemsep=0pt
-\item prop.h: base property class header
-\item proplist.h: wxPropertyListView and associated classes
-\item propform.h: wxPropertyListView and associated classes
-\end{itemize}
-
-\section{Topic overviews}\label{proplistoverviews}
-
-This chapter contains a selection of topic overviews.
-
-\subsection{Property classes overview}\label{proplistpropertyoverview}
-
-The property classes help a programmer to express relationships between
-data and physical windows, in particular:
-
-\begin{itemize}\itemsep=0pt
-\item the transfer of data to and from the physical controls;
-\item the behaviour of various controls and custom windows for particular
-types of data;
-\item the validation of data, notifying the user when incorrect data is entered,
-or even better, constraining the input so only valid data can be entered.
-\end{itemize}
-
-With a consistent framework, the programmer should be able to use existing
-components and design new ones in a principled manner, to solve many data entry
-requirements.
-
-Each datum is represented in a \helpref{wxProperty}{wxproperty}, which has a name and a value.
-Various C++ types are permitted in the value of a property, and the property can store a pointer
-to the data instead of a copy of the data. A \helpref{wxPropertySheet}{wxpropertysheet} represents a number of these properties.
-
-These two classes are independent from the way in which the data is visually manipulated. To
-mediate between property sheets and windows, the abstract class \helpref{wxPropertyView}{wxpropertyview} is
-available for programmers to derive new kinds of view. One kind of view that is available is the \helpref{wxPropertyListView}{wxpropertylistview},
-which displays the data in a Visual Basic-style list, with a small number of controls for editing
-the currently selected property. Another is \helpref{wxPropertyFormView}{wxpropertyformview} which
-mediates between an existing dialog or panel and the property sheet.
-
-The hard work of mediation is actually performed by validators, which are instances of classes
-derived from \helpref{wxPropertyValidator}{wxpropertyvalidator}. A validator is associated with
-a particular property and is responsible for
-responding to user interface events, and displaying, updating and checking the property value.
-Because a validator's behaviour depends largely on the kind of view being used, there has to be
-a separate hierarchy of validators for each class of view. So for wxPropertyListView, there is
-an abstract class \helpref{wxPropertyListValidator}{wxpropertylistvalidator} from which concrete
-classes are derived, such as \helpref{wxRealListValidator}{wxreallistvalidator} and
-\rtfsp\helpref{wxStringListValidator}{wxstringlistvalidator}.
-
-A validator can be explicitly set for a property, so there is no doubt which validator
-should be used to edit that property. However, it is also possible to define a registry
-of validators, and have the validator chosen on the basis of the {\it role} of the property.
-So a property with a ``filename" role would match the ``filename" validator, which pops
-up a file selector when the user double clicks on the property.
-
-You don't have to define your own frame or window classes: there are some predefined
-that will work with the property list view. See \helpref{Window classes}{proplistwindowclasses} for
-further details.
-
-\subsubsection{Example 1: Property list view}
-
-The following code fragment shows the essentials of creating a registry of
-standard validators, a property sheet containing some properties, and
-a property list view and dialog or frame. RegisterValidators will be
-called on program start, and PropertySheetTest is called in response to a
-menu command.
-
-Note how some properties are created with an explicit reference to
-a validator, and others are provided with a ``role'' which can be matched
-against a validator in the registry.
-
-The interface generated by this test program is shown in the section \helpref{Appearance and
-behaviour of a property list view}{proplistappearance}.
-
-\begin{verbatim}
-void RegisterValidators(void)
-{
- myListValidatorRegistry.RegisterValidator((wxString)"real", new wxRealListValidator);
- myListValidatorRegistry.RegisterValidator((wxString)"string", new wxStringListValidator);
- myListValidatorRegistry.RegisterValidator((wxString)"integer", new wxIntegerListValidator);
- myListValidatorRegistry.RegisterValidator((wxString)"bool", new wxBoolListValidator);
-}
-
-void PropertyListTest(Bool useDialog)
-{
- wxPropertySheet *sheet = new wxPropertySheet;
-
- sheet->AddProperty(new wxProperty("fred", 1.0, "real"));
- sheet->AddProperty(new wxProperty("tough choice", (Bool)true, "bool"));
- sheet->AddProperty(new wxProperty("ian", (long)45, "integer", new wxIntegerListValidator(-50, 50)));
- sheet->AddProperty(new wxProperty("bill", 25.0, "real", new wxRealListValidator(0.0, 100.0)));
- sheet->AddProperty(new wxProperty("julian", "one", "string"));
- sheet->AddProperty(new wxProperty("bitmap", "none", "string", new wxFilenameListValidator("Select a bitmap file", "*.bmp")));
- wxStringList *strings = new wxStringList("one", "two", "three", NULL);
- sheet->AddProperty(new wxProperty("constrained", "one", "string", new wxStringListValidator(strings)));
-
- wxPropertyListView *view =
- new wxPropertyListView(NULL,
- wxPROP_BUTTON_CHECK_CROSS|wxPROP_DYNAMIC_VALUE_FIELD|wxPROP_PULLDOWN);
-
- wxDialogBox *propDialog = NULL;
- wxPropertyListFrame *propFrame = NULL;
- if (useDialog)
- {
- propDialog = new wxPropertyListDialog(view, NULL, "Property Sheet Test", true, -1, -1, 400, 500);
- }
- else
- {
- propFrame = new wxPropertyListFrame(view, NULL, "Property Sheet Test", -1, -1, 400, 500);
- }
-
- view->AddRegistry(&myListValidatorRegistry);
-
- if (useDialog)
- {
- view->ShowView(sheet, propDialog);
- propDialog->Centre(wxBOTH);
- propDialog->Show(true);
- }
- else
- {
- propFrame->Initialize();
- view->ShowView(sheet, propFrame->GetPropertyPanel());
- propFrame->Centre(wxBOTH);
- propFrame->Show(true);
- }
-}
-\end{verbatim}
-
-\subsubsection{Example 2: Property form view}
-
-This example is similar to Example 1, but uses a property form view to
-edit a property sheet using a predefined dialog box.
-
-\begin{verbatim}
-void RegisterValidators(void)
-{
- myFormValidatorRegistry.RegisterValidator((wxString)"real", new wxRealFormValidator);
- myFormValidatorRegistry.RegisterValidator((wxString)"string", new wxStringFormValidator);
- myFormValidatorRegistry.RegisterValidator((wxString)"integer", new wxIntegerFormValidator);
- myFormValidatorRegistry.RegisterValidator((wxString)"bool", new wxBoolFormValidator);
-}
-
-void PropertyFormTest(Bool useDialog)
-{
- wxPropertySheet *sheet = new wxPropertySheet;
-
- sheet->AddProperty(new wxProperty("fred", 25.0, "real", new wxRealFormValidator(0.0, 100.0)));
- sheet->AddProperty(new wxProperty("tough choice", (Bool)true, "bool"));
- sheet->AddProperty(new wxProperty("ian", (long)45, "integer", new wxIntegerFormValidator(-50, 50)));
- sheet->AddProperty(new wxProperty("julian", "one", "string"));
- wxStringList *strings = new wxStringList("one", "two", "three", NULL);
- sheet->AddProperty(new wxProperty("constrained", "one", "string", new wxStringFormValidator(strings)));
-
- wxPropertyFormView *view = new wxPropertyFormView(NULL);
-
- wxDialogBox *propDialog = NULL;
- wxPropertyFormFrame *propFrame = NULL;
- if (useDialog)
- {
- propDialog = new wxPropertyFormDialog(view, NULL, "Property Form Test", true, -1, -1, 400, 300);
- }
- else
- {
- propFrame = new wxPropertyFormFrame(view, NULL, "Property Form Test", -1, -1, 400, 300);
- propFrame->Initialize();
- }
-
- wxPanel *panel = propDialog ? propDialog : propFrame->GetPropertyPanel();
- panel->SetLabelPosition(wxVERTICAL);
-
- // Add items to the panel
-
- (void) new wxButton(panel, (wxFunction)NULL, "OK", -1, -1, -1, -1, 0, "ok");
- (void) new wxButton(panel, (wxFunction)NULL, "Cancel", -1, -1, 80, -1, 0, "cancel");
- (void) new wxButton(panel, (wxFunction)NULL, "Update", -1, -1, 80, -1, 0, "update");
- (void) new wxButton(panel, (wxFunction)NULL, "Revert", -1, -1, -1, -1, 0, "revert");
- panel->NewLine();
-
- // The name of this text item matches the "fred" property
- (void) new wxText(panel, (wxFunction)NULL, "Fred", "", -1, -1, 90, -1, 0, "fred");
- (void) new wxCheckBox(panel, (wxFunction)NULL, "Yes or no", -1, -1, -1, -1, 0, "tough choice");
- (void) new wxSlider(panel, (wxFunction)NULL, "Sliding scale", 0, -50, 50, 100, -1, -1, wxHORIZONTAL, "ian");
- panel->NewLine();
- (void) new wxListBox(panel, (wxFunction)NULL, "Constrained", wxSINGLE, -1, -1, 100, 90, 0, NULL, 0, "constrained");
-
- view->AddRegistry(&myFormValidatorRegistry);
-
- if (useDialog)
- {
- view->ShowView(sheet, propDialog);
- view->AssociateNames();
- view->TransferToDialog();
- propDialog->Centre(wxBOTH);
- propDialog->Show(true);
- }
- else
- {
- view->ShowView(sheet, propFrame->GetPropertyPanel());
- view->AssociateNames();
- view->TransferToDialog();
- propFrame->Centre(wxBOTH);
- propFrame->Show(true);
- }
-}
-\end{verbatim}
-
-\subsection{Validator classes overview}\label{proplistvalidatoroverview}
-
-Classes: \helpref{Validator classes}{proplistvalidatorclasses}
-
-The validator classes provide functionality for mediating between a wxProperty and
-the actual display. There is a separate family of validator classes for each
-class of view, since the differences in user interface for these views implies
-that little common functionality can be shared amongst validators.
-
-
-
-\subsubsection{wxPropertyValidator overview}\label{wxpropertyvalidatoroverview}
-
-Class: \helpref{wxPropertyValidator}{wxpropertyvalidator}
-
-This class is the root of all property validator classes. It contains a small
-amount of common functionality, including functions to convert between
-strings and C++ values.
-
-A validator is notionally an object which sits between a property and its displayed
-value, and checks that the value the user enters is correct, giving an error message
-if the validation fails. In fact, the validator does more than that, and is akin to
-a view class but at a finer level of detail. It is also responsible for
-loading the dialog box control with the value from the property, putting it back
-into the property, preparing special controls for editing the value, and
-may even invoke special dialogs for editing the value in a convenient way.
-
-In a property list dialog, there is quite a lot of scope for supplying custom dialogs,
-such as file or colour selectors. For a form dialog, there is less scope because
-there is no concept of `detailed editing' of a value: one control is associated with
-one property, and there is no provision for invoking further dialogs. The reader
-may like to work out how the form view could be extended to provide some of the
-functionality of the property list!
-
-Validator objects may be associated explicitly with a wxProperty, or they may be
-indirectly associated by virtue of a property `kind' that matches validators having
-that kind. In the latter case, such validators are stored in a validator registry
-which is passed to the view before the dialog is shown. If the validator takes
-arguments, such as minimum and maximum values in the case of a wxIntegerListValidator,
-then the validator must be associated explicitly with the property. The validator
-will be deleted when the property is deleted.
-
-\subsubsection{wxPropertyListValidator overview}\label{wxpropertylistvalidatoroverview}
-
-Class: \helpref{wxPropertyListValidator}{wxpropertylistvalidator}
-
-This class is the abstract base class for property list view validators.
-The list view acts upon a user interface containing a list of properties,
-a text item for direct property value editing, confirm/cancel buttons for the value,
-a pulldown list for making a choice between values, and OK/Cancel/Help buttons
-for the dialog (see \helpref{property list appearance}{proplistappearance}).
-
-By overriding virtual functions, the programmer can create custom
-behaviour for different kinds of property. Custom behaviour can use just the
-available controls on the property list dialog, or the validator can
-invoke custom editors with quite different controls, which pop up in
-`detailed editing' mode.
-
-See the detailed class documentation for the members you should override
-to give your validator appropriate behaviour.
-
-\subsubsection{wxPropertyFormValidator overview}\label{wxpropertyformvalidatoroverview}
-
-This class is the abstract base class for property form view validators.
-The form view acts upon an existing dialog box or panel, where either the
-panel item names correspond to property names, or the programmer has explicitly
-associated the panel item with the property.
-
-By overriding virtual functions, the programmer determines how
-values are displayed or retrieved, and the checking that the validator does.
-
-See the detailed class documentation for the members you should override
-to give your validator appropriate behaviour.
-
-\subsection{View classes overview}\label{proplistviewoverview}
-
-Classes: \helpref{View classes}{proplistviewclasses}
-
-An instance of a view class relates a property sheet with an actual window.
-Currently, there are two classes of view: wxPropertyListView and wxPropertyFormView.
-
-\subsubsection{wxPropertyView overview}\label{wxpropertyviewoverview}
-
-Class: \helpref{wxPropertyView}{wxpropertyview}
-
-This is the abstract base class for property views.
-
-\subsubsection{wxPropertyListView overview}\label{wxpropertylistviewoverview}
-
-Class: \helpref{wxPropertyListView}{wxpropertylistview}
-
-The property list view defines the relationship between a property sheet and
-a property list dialog or panel. It manages user interface events such as
-clicking on a property, pressing return in the text edit field, and clicking
-on Confirm or Cancel. These events cause member functions of the
-class to be called, and these in turn may call member functions of
-the appropriate validator to be called, to prepare controls, check the property value,
-invoke detailed editing, etc.
-
-\subsubsection{wxPropertyFormView overview}\label{wxpropertyformviewoverview}
-
-Class: \helpref{wxPropertyFormView}{wxpropertyformview}
-
-The property form view manages the relationship between a property sheet
-and an existing dialog or panel.
-
-You must first create a panel or dialog box for the view to work on.
-The panel should contain panel items with names that correspond to
-properties in your property sheet; or you can explicitly set the
-panel item for each property.
-
-Apart from any custom panel items that you wish to control independently
-of the property-editing items, wxPropertyFormView takes over the
-processing of item events. It can also control normal dialog behaviour such
-as OK, Cancel, so you should also create some standard buttons that the property view
-can recognise. Just create the buttons with standard names and the view
-will do the rest. The following button names are recognised:
-
-\begin{itemize}\itemsep=0pt
-\item {\bf ok}: indicates the OK button. Calls wxPropertyFormView::OnOk. By default,
-checks and updates the form values, closes and deletes the frame or dialog, then deletes the view.
-\item {\bf cancel}: indicates the Cancel button. Calls wxPropertyFormView::OnCancel. By default,
-closes and deletes the frame or dialog, then deletes the view.
-\item {\bf help}: indicates the Help button. Calls wxPropertyFormView::OnHelp. This needs
-to be overridden by the application for anything interesting to happen.
-\item {\bf revert}: indicates the Revert button. Calls wxPropertyFormView::OnRevert,
-which by default transfers the wxProperty values to the panel items (in effect
-undoing any unsaved changes in the items).
-\item {\bf update}: indicates the Revert button. Calls wxPropertyFormView::OnUpdate, which
-by defaults transfers the displayed values to the wxProperty objects.
-\end{itemize}
-
-\subsection{wxPropertySheet overview}\label{wxpropertysheetoverview}
-
-Classes: \helpref{wxPropertySheet}{wxpropertysheet}, \helpref{wxProperty}{wxproperty}, \helpref{wxPropertyValue}{wxpropertyvalue}
-
-A property sheet defines zero or more properties. This is a bit like an explicit representation of
-a C++ object. wxProperty objects can have values which are pointers to C++ values, or they
-can allocate their own storage for values.
-
-Because the property sheet representation is explicit and can be manipulated by
-a program, it is a convenient form to be used for a variety of
-editing purposes. wxPropertyListView and wxPropertyFormView are two classes that
-specify the relationship between a property sheet and a user interface. You could imagine
-other uses for wxPropertySheet, for example to generate a form-like user interface without
-the need for GUI programming. Or for storing the names and values of command-line switches, with the
-option to subsequently edit these values using a wxPropertyListView.
-
-A typical use for a property sheet is to represent values of an object
-which are only implicit in the current representation of it. For
-example, in Visual Basic and similar programming environments, you can
-`edit a button', or rather, edit the button's properties. One of the
-properties you can edit is {\it width} - but there is no explicit
-representation of width in a wxWindows button; instead, you call SetSize
-and GetSize members. To translate this into a consistent,
-property-oriented scheme, we could derive a new class
-wxButtonWithProperties, which has two new functions: SetProperty and
-GetProperty. SetProperty accepts a property name and a value, and calls
-an appropriate function for the property that is being passed.
-GetProperty accepts a property name, returning a property value. So
-instead of having to use the usual arbitrary set of C++ member functions
-to set or access attributes of a window, programmer deals merely with
-SetValue/GetValue, and property names and values.
-We now have a single point at which we can modify or query an object by specifying
-names and values at run-time. (The implementation of SetProperty and GetProperty
-is probably quite messy and involves a large if-then-else statement to
-test the property name and act accordingly.)
-
-When the user invokes the property editor for a wxButtonWithProperties, the system
-creates a wxPropertySheet with `imaginary' properties such as width, height, font size
-and so on. For each property, wxButtonWithProperties::GetProperty is called, and the result is
-passed to the corresponding wxProperty. The wxPropertySheet is passed to a wxPropertyListView
-as described elsewhere, and the user edits away. When the user has finished editing, the system calls
-wxButtonWithProperties::SetProperty to transfer the wxProperty value back into the button
-by way of an appropriate call, wxWindow::SetSize in the case of width and height properties.
-
-\section{Classes by category}\label{proplistclassesbycat}
-
-A classification of property sheet classes by category.
-
-\subsection{Data classes}
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxProperty}{wxproperty}
-\item \helpref{wxPropertyValue}{wxpropertyvalue}
-\item \helpref{wxPropertySheet}{wxpropertysheet}
-\end{itemize}
-
-\subsection{Validator classes}\label{proplistvalidatorclasses}
-
-Validators check that the values the user has entered for a property are
-valid. They can also define specific ways of entering data, such as a
-file selector for a filename, and they are responsible for transferring
-values between the wxProperty and the physical display.
-
-Base classes:
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxPropertyValidator}{wxproperty}
-\item \helpref{wxPropertyListValidator}{wxpropertylistvalidator}
-\item \helpref{wxPropertyFormValidator}{wxpropertyformvalidator}
-\end{itemize}
-
-List view validators:
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxBoolListValidator}{wxboollistvalidator}
-\item \helpref{wxFilenameListValidator}{wxfilenamelistvalidator}
-\item \helpref{wxIntegerListValidator}{wxintegerlistvalidator}
-\item \helpref{wxListOfStringsListValidator}{wxlistofstringslistvalidator}
-\item \helpref{wxRealListValidator}{wxreallistvalidator}
-\item \helpref{wxStringListValidator}{wxstringlistvalidator}
-\end{itemize}
-
-Form view validators:
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxBoolFormValidator}{wxboolformvalidator}
-\item \helpref{wxIntegerFormValidator}{wxintegerformvalidator}
-\item \helpref{wxRealFormValidator}{wxrealformvalidator}
-\item \helpref{wxStringFormValidator}{wxstringformvalidator}
-\end{itemize}
-
-\subsection{View classes}\label{proplistviewclasses}
-
-View classes mediate between a property sheet and a physical window.
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxPropertyView}{wxpropertyview}
-\item \helpref{wxPropertyListView}{wxpropertylistview}
-\item \helpref{wxPropertyFormView}{wxpropertyformview}
-\end{itemize}
-
-\subsection{Window classes}\label{proplistwindowclasses}
-
-The class library defines some window classes that can be used as-is with a suitable
-view class and property sheet.
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxPropertyFormFrame}{wxpropertyformframe}
-\item \helpref{wxPropertyFormDialog}{wxpropertyformdialog}
-\item \helpref{wxPropertyFormPanel}{wxpropertyformpanel}
-\item \helpref{wxPropertyListFrame}{wxpropertylistframe}
-\item \helpref{wxPropertyListDialog}{wxpropertylistdialog}
-\item \helpref{wxPropertyListPanel}{wxpropertylistpanel}
-\end{itemize}
-
-\subsection{Registry classes}
-
-A validator registry is a list of validators that can be applied to properties in a property sheet.
-There may be one or more registries per property view.
-
-\begin{itemize}\itemsep=0pt
-\item \helpref{wxPropertyValidatorRegistry}{wxpropertyvalidatorregistry}
-\end{itemize}
+++ /dev/null
-\section{\class{wxPropertyListValidator}}\label{wxpropertylistvalidator}
-
-The {\bf wxPropertyListValidator} abstract class is the base class for
-deriving validators for property lists.
-
-\wxheading{See also}
-
-\helpref{wxPropertyListValidator overview}{wxpropertylistvalidatoroverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyListValidator::wxPropertyListValidator}
-
-\func{void}{wxPropertyListValidator}{\param{long}{ flags = wxPROP\_ALLOW\_TEXT\_EDITING}}
-
-Constructor.
-
-\membersection{wxPropertyListValidator::\destruct{wxPropertyListValidator}}
-
-\func{void}{\destruct{wxPropertyListValidator}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyListValidator::OnCheckValue}
-
-\func{bool}{OnCheckValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the Tick (Confirm) button is pressed or focus is list. Return false if the value
-was invalid, which is a signal restores the old value. Return true if the value was valid.
-
-\membersection{wxPropertyListValidator::OnClearControls}
-
-\func{bool}{OnClearControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Allows the clearing (enabling, disabling) of property list controls, when the focus leaves the current property.
-
-\membersection{wxPropertyListValidator::OnClearDetailControls}
-
-\func{bool}{OnClearDetailControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the focus is lost, if the validator is in detailed editing mode.
-
-\membersection{wxPropertyListValidator::OnDisplayValue}
-
-\func{bool}{OnDisplayValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Should display the value in the appropriate controls. The default implementation gets the
-textual value from the property and inserts it into the text edit control.
-
-\membersection{wxPropertyListValidator::OnDoubleClick}
-
-\func{bool}{OnDoubleClick}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the property is double clicked. Extra functionality can be provided,
-such as cycling through possible values.
-
-\membersection{wxPropertyListValidator::OnEdit}
-
-\func{bool}{OnEdit}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the Edit (detailed editing) button is pressed. The default implementation
-calls wxPropertyListView::BeginDetailedEditing; a filename validator (for example) overrides
-this function to show the file selector.
-
-\membersection{wxPropertyListValidator::OnPrepareControls}
-
-\func{bool}{OnPrepareControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called to allow the validator to setup the display, such enabling or disabling buttons, and
-setting the values and selection in the standard listbox control (the one optionally used for displaying
-value options).
-
-\membersection{wxPropertyListValidator::OnPrepareDetailControls}
-
-\func{bool}{OnPrepareDetailControls}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the property is edited `in detail', i.e. when the Edit button is pressed.
-
-\membersection{wxPropertyListValidator::OnRetrieveValue}
-
-\func{bool}{OnRetrieveValue}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when Tick (Confirm) is pressed or focus is lost or view wants to update
-the property list. Should do the transfer from the property editing area to the property itself
-
-\membersection{wxPropertyListValidator::OnSelect}
-
-\func{bool}{OnSelect}{\param{bool}{ select}, \param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the property is selected or deselected: typically displays the value
-in the edit control (having chosen a suitable control to display: (non)editable text or listbox).
-
-\membersection{wxPropertyListValidator::OnValueListSelect}
-
-\func{bool}{OnValueListSelect}{\param{wxProperty *}{property}, \param{wxPropertyListView *}{view},
- \param{wxWindow *}{parentWindow}}
-
-Called when the value listbox is selected. The default behaviour is to copy
-string to text control, and retrieve the value into the property.
-
+++ /dev/null
-\section{\class{wxListOfStringsListValidator}}\label{wxlistofstringslistvalidator}
-
-This class validates a list of strings for a list view. When editing the property,
-a dialog box is presented for adding, deleting or editing entries in the list.
-At present no constraints may be supplied.
-
-You can construct a string list property value by constructing a wxStringList object.
-
-For example:
-
-\begin{verbatim}
- myListValidatorRegistry.RegisterValidator((wxString)"stringlist",
- new wxListOfStringsListValidator);
-
- wxStringList *strings = new wxStringList("earth", "fire", "wind", "water", NULL);
-
- sheet->AddProperty(new wxProperty("fred", strings, "stringlist"));
-\end{verbatim}
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxListOfStringsListValidator::wxListofStringsListValidator}
-
-\func{void}{wxListOfStringsListValidator}{\param{long}{ flags=0}}
-
-Constructor.
-
+++ /dev/null
-\section{\class{wxPropertyListView}}\label{wxpropertylistview}
-
-The {\bf wxPropertyListView} class shows a wxPropertySheet as a Visual Basic-style property list.
-
-\wxheading{See also}
-
-\helpref{wxPropertyListView overview}{wxpropertylistviewoverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyListView::wxPropertyListView}
-
-\func{void}{wxPropertyListView}{ \param{wxPanel*} propPanel = NULL, \param{long}{ flags = wxPROP\_BUTTON\_DEFAULT}}
-
-Constructor.
-
-The {\it flags} argument can be a bit list of the following:
-
-\begin{itemize}\itemsep=0pt
-\item wxPROP\_BUTTON\_CLOSE
-\item wxPROP\_BUTTON\_OK
-\item wxPROP\_BUTTON\_CANCEL
-\item wxPROP\_BUTTON\_CHECK\_CROSS
-\item wxPROP\_BUTTON\_HELP
-\item wxPROP\_DYNAMIC\_VALUE\_FIELD
-\item wxPROP\_PULLDOWN
-\end{itemize}
-
-\membersection{wxPropertyListView::\destruct{wxPropertyListView}}
-
-\func{void}{\destruct{wxPropertyListView}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyListView::AssociatePanel}\label{wxpropertylistviewassociatepanel}
-
-\func{void}{AssociatePanel}{\param{wxPanel *}{panel}}
-
-Associates the window on which the controls will be displayed, with the view (sets an internal pointer to the window).
-
-\membersection{wxPropertyListView::BeginShowingProperty}\label{wxpropertylistviewbeginshowingproperty}
-
-\func{bool}{BeginShowingProperty}{\param{wxProperty *}{property}}
-
-Finds the appropriate validator and loads the property into the controls, by calling
-wxPropertyValidator::OnPrepareControls and then wxPropertyListView::DisplayProperty.
-
-\membersection{wxPropertyListView::DisplayProperty}\label{wxpropertylistviewdisplayproperty}
-
-\func{bool}{DisplayProperty}{\param{wxProperty *}{property}}
-
-Calls wxPropertyValidator::OnDisplayValue for the current property's validator. This function
-gets called by wxPropertyListView::BeginShowingProperty, which is in turn called
-from ShowProperty, called by OnPropertySelect, called by the listbox callback when selected.
-
-\membersection{wxPropertyListView::EndShowingProperty}\label{wxpropertylistviewendshowingproperty}
-
-\func{bool}{EndShowingProperty}{\param{wxProperty *}{property}}
-
-Finds the appropriate validator and unloads the property from the controls, by calling
-wxPropertyListView::RetrieveProperty, wxPropertyValidator::OnClearControls and (if we're in
-detailed editing mode) wxPropertyValidator::OnClearDetailControls.
-
-\membersection{wxPropertyListView::GetPanel}\label{wxpropertylistviewgetpanel}
-
-\func{wxPanel *}{GetPanel}{\void}
-
-Returns the panel associated with the view.
-
-\membersection{wxPropertyListView::GetManagedWindow}\label{wxpropertylistviewgetmanagedwindow}
-
-\func{wxWindow *}{GetManagedWindow}{\void}
-
-Returns the managed window (a frame or dialog) associated with the view.
-
-\membersection{wxPropertyListView::GetWindowCancelButton}\label{wxpropertylistviewgetwindowcancelbutton}
-
-\func{wxButton *}{GetWindowCancelButton}{\void}
-
-Returns the window cancel button, if any.
-
-\membersection{wxPropertyListView::GetWindowCloseButton}\label{wxpropertylistviewgetwindowclosebutton}
-
-\func{wxButton *}{GetWindowCloseButton}{\void}
-
-Returns the window close or OK button, if any.
-
-\membersection{wxPropertyListView::GetWindowHelpButton}\label{wxpropertylistviewgetwindowhelpbutton}
-
-\func{wxButton *}{GetWindowHelpButton}{\void}
-
-Returns the window help button, if any.
-
-\membersection{wxPropertyListView::SetManagedWindow}\label{wxpropertylistviewsetmanagedwindow}
-
-\func{void}{SetManagedWindow}{\param{wxWindow *}{win}}
-
-Sets the managed window (a frame or dialog) associated with the view.
-
-\membersection{wxPropertyListView::UpdatePropertyDisplayInList}\label{wxpropertylistviewupdatepropdisplay}
-
-\func{bool}{UpdatePropertyDisplayInList}{\param{wxProperty *}{property}}
-
-Updates the display for the given changed property.
-
-\membersection{wxPropertyListView::UpdatePropertyList}\label{wxpropertylistviewupdateproplist}
-
-\func{bool}{UpdatePropertyList}{\param{bool }{clearEditArea = true}}
-
-Updates the whole property list display.
-
+++ /dev/null
-\section{\class{wxPropertyValidatorRegistry}}\label{wxpropertyvalidatorregistry}
-
-The {\bf wxPropertyValidatorRegistry} class is used for storing validators,
-indexed by the `role name' of the property, by which groups of property
-can be identified for the purpose of validation and editing.
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyValidatorRegistry::wxPropertyValidatorRegistry}
-
-\func{void}{wxPropertyValidatorRegistry}{\void}
-
-Constructor.
-
-\membersection{wxPropertyValidatorRegistry::\destruct{wxPropertyValidatorRegistry}}
-
-\func{void}{\destruct{wxPropertyValidatorRegistry}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyValidatorRegistry::Clear}
-
-\func{void}{ClearRegistry}{\void}
-
-Clears the registry, deleting the validators.
-
-\membersection{wxPropertyValidatorRegistry::GetValidator}
-
-\func{wxPropertyValidator *}{GetValidator}{\param{wxString\& }{roleName}}
-
-Retrieve a validator by the property role name.
-
-\membersection{wxPropertyValidatorRegistry::RegisterValidator}\label{wxpropertyvalidatorregistervalidator}
-
-\func{void}{RegisterValidator}{\param{wxString\& }{roleName}, \param{wxPropertyValidator *}{validator}}
-
-Register a validator with the registry. {\it roleName} is a name indicating the
-role of the property, such as ``filename''. Later, when a validator is chosen for
-editing a property, this role name is matched against the class names of the property,
-if the property does not already have a validator explicitly associated with it.
-
-
+++ /dev/null
-\section{\class{wxRealFormValidator}}\label{wxrealformvalidator}
-
-This class validates a range of real values for form views. The associated panel item must be a wxText.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxRealFormValidator::wxRealFormValidator}
-
-\func{void}{wxRealFormValidator}{\param{float }{min=0.0}, \param{float }{max=0.0},
- \param{long}{ flags=0}}
-
-Constructor. Assigning zero to minimum and maximum values indicates that there is no range to check.
-
+++ /dev/null
-\section{\class{wxRealListValidator}}\label{wxreallistvalidator}
-
-This class validates a range of real values for property lists.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\helpref{wxPropertySheet overview}{wxpropertysheetoverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxRealListValidator::wxRealListValidator}
-
-\func{void}{wxRealListValidator}{\param{float }{min=0.0}, \param{float }{max=0.0},
- \param{long}{ flags=wxPROP\_ALLOW\_TEXT\_EDITING}}
-
-Constructor. Assigning zero to minimum and maximum values indicates that there is no range to check.
-
+++ /dev/null
-\section{\class{wxPropertySheet}}\label{wxpropertysheet}
-
-The {\bf wxPropertySheet} class is used for storing a number of
-wxProperty objects (essentially names and values).
-
-\wxheading{See also}
-
-\helpref{wxPropertySheet overview}{wxpropertysheetoverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertySheet::wxPropertySheet}
-
-\func{void}{wxPropertySheet}{\param{const wxString}{ name = ""}}
-
-Constructor. Sets property sheet's name to name if present.
-
-\membersection{wxPropertySheet::\destruct{wxPropertySheet}}
-
-\func{void}{\destruct{wxPropertySheet}}{\void}
-
-Destructor. Destroys all contained properties.
-
-\membersection{wxPropertySheet::AddProperty}\label{wxpropertysheetaddproperty}
-
-\func{void}{AddProperty}{\param{wxProperty *}{property}}
-
-Adds a property to the sheet.
-
-\membersection{wxPropertySheet::Clear}\label{wxpropertysheetclear}
-
-\func{void}{Clear}{\void}
-
-Clears all the properties from the sheet (deleting them).
-
-\membersection{wxPropertySheet::GetName}\label{wxpropertysheetgetname}
-
-\func{wxString}{GetName}{\void}
-
-Gets the sheet's name.
-
-\membersection{wxPropertySheet::GetProperty}\label{wxpropertysheetgetproperty}
-
-\func{wxProperty *}{GetProperty}{\param{wxString}{ name}}
-
-Gets a property by name.
-
-\membersection{wxPropertySheet::GetProperties}\label{wxpropertysheetgetproperties}
-
-\func{wxList\&}{GetProperties}{\void}
-
-Returns a reference to the internal list of properties.
-
-\membersection{wxPropertySheet::HasProperty}\label{wxpropertysheethasproperty}
-
-\func{bool}{HasProperty}{\param{wxString}{ propname}}
-
-Returns true if sheet contains property propname.
-
-\membersection{wxPropertySheet::RemoveProperty}\label{wxpropertysheetremoveproperty}
-
-\func{void}{RemoveProperty}{\param{wxString}{ propname}}
-
-Removes property propname from sheet, deleting it.
-
-\membersection{wxPropertySheet::SetName}\label{wxpropertysheetsetname}
-
-\func{void}{SetName}{\param{wxString}{ sheetname}}
-
-Set the sheet's name to sheetname
-
-\membersection{wxPropertySheet::SetProperty}\label{wxpropertysheetsetproperty}
-
-\func{bool}{SetProperty}{\param{wxString}{ propname}, \param{wxPropertyValue}{ value}}
-
-Sets property propname to value. Returns false if property is not a member of sheet.
-
-\membersection{wxPropertySheet::SetAllModified}
-
-\func{void}{SetAllModified}{\param{bool}{ flag}}
-
-Sets the `modified' flag of each property value.
-
+++ /dev/null
-\section{\class{wxStringListValidator}}\label{wxstringlistvalidator}
-
-This class validates a string value, with an optional choice of possible values.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxStringListValidator::wxStringListValidator}
-
-\func{void}{wxStringListValidator}{\param{wxStringList *}{list=NULL}, \param{long}{ flags=0}}
-
-Constructor. Supply a list of strings to indicate a choice, or no strings to allow the
-user to freely edit the string. The string list will be deleted when the validator is deleted.
-
-
+++ /dev/null
-\section{\class{wxStringFormValidator}}\label{wxstringformvalidator}
-
-This class validates a string value for a form view, with an optional choice of possible values.
-The associated panel item must be a wxText, wxListBox or wxChoice. For wxListBox and wxChoice items,
-if the item is empty, the validator attempts to initialize the item from the strings in
-the validator.
-
-\wxheading{See also}
-
-\helpref{Validator classes}{proplistvalidatorclasses}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxStringFormValidator::wxStringFormValidator}
-
-\func{void}{wxStringFormValidator}{\param{wxStringList *}{list=NULL}, \param{long}{ flags=0}}
-
-Constructor. Supply a list of strings to indicate a choice, or no strings to allow the
-user to freely edit the string. The string list will be deleted when the validator is deleted.
-
+++ /dev/null
-\section{\class{wxPropertyValue}}\label{wxpropertyvalue}
-
-The {\bf wxPropertyValue} class represents the value of a property,
-and is normally associated with a wxProperty object.
-
-A wxPropertyValue has one of the following types:
-
-\begin{itemize}\itemsep=0pt
-\item wxPropertyValueNull
-\item wxPropertyValueInteger
-\item wxPropertyValueReal
-\item wxPropertyValueBool
-\item wxPropertyValueString
-\item wxPropertyValueList
-\item wxPropertyValueIntegerPtr
-\item wxPropertyValueRealPtr
-\item wxPropertyValueBoolPtr
-\item wxPropertyValueStringPtr
-\end{itemize}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyValue::wxPropertyValue}
-
-\func{void}{wxPropertyValue}{\void}
-
-Default constructor.
-
-\func{void}{wxPropertyValue}{\param{const wxPropertyValue\& }{copyFrom}}
-
-Copy constructor.
-
-\func{void}{wxPropertyValue}{\param{char *}{val}}
-
-Construction from a string value.
-
-\func{void}{wxPropertyValue}{\param{long}{ val}}
-
-Construction from an integer value. You may need to cast to (long) to
-avoid confusion with other constructors (such as the bool constructor).
-
-\func{void}{wxPropertyValue}{\param{bool}{ val}}
-
-Construction from a boolean value.
-
-\func{void}{wxPropertyValue}{\param{float}{ val}}
-
-Construction from a floating point value.
-
-\func{void}{wxPropertyValue}{\param{double}{ val}}
-
-Construction from a floating point value.
-
-\func{void}{wxPropertyValue}{\param{wxList *}{ val}}
-
-Construction from a list of wxPropertyValue objects. The
-list, but not each contained wxPropertyValue, will be deleted
-by the constructor. The wxPropertyValues will be assigned to
-this wxPropertyValue list. In other words, so do not delete wxList or
-its data after calling this constructor.
-
-\func{void}{wxPropertyValue}{\param{wxStringList *}{ val}}
-
-Construction from a list of strings. The list (including the strings
-contained in it) will be deleted by the constructor, so do not
-destroy {\it val} explicitly.
-
-\func{void}{wxPropertyValue}{\param{char **}{val}}
-
-Construction from a string pointer.
-
-\func{void}{wxPropertyValue}{\param{long *}{val}}
-
-Construction from an integer pointer.
-
-\func{void}{wxPropertyValue}{\param{bool *}{val}}
-
-Construction from an boolean pointer.
-
-\func{void}{wxPropertyValue}{\param{float *}{val}}
-
-Construction from a floating point pointer.
-
-The last four constructors use pointers to various C++ types, and do not
-store the types themselves; this allows the values to stand in for actual
-data values defined elsewhere.
-
-\membersection{wxPropertyValue::\destruct{wxPropertyValue}}
-
-\func{void}{\destruct{wxPropertyValue}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyValue::Append}
-
-\func{void}{Append}{\param{wxPropertyValue *}{expr}}
-
-Appends a property value to the list.
-
-\membersection{wxPropertyValue::BoolValue}
-
-\func{bool}{BoolValue}{\void}
-
-Returns the boolean value.
-
-\membersection{wxPropertyValue::BoolValuePtr}
-
-\func{bool *}{BoolValuePtr}{\void}
-
-Returns the pointer to the boolean value.
-
-\membersection{wxPropertyValue::ClearList}
-
-\func{void}{ClearList}{\void}
-
-Deletes the contents of the list.
-
-\membersection{wxPropertyValue::Delete}
-
-\func{void}{Delete}{\param{wxPropertyValue *}{expr}}
-
-Deletes {\it expr} from this list.
-
-\membersection{wxPropertyValue::GetFirst}
-
-\func{wxPropertyValue *}{GetFirst}{\void}
-
-Gets the first value in the list.
-
-\membersection{wxPropertyValue::GetLast}
-
-\func{wxPropertyValue *}{GetFirst}{\void}
-
-Gets the last value in the list.
-
-\membersection{wxPropertyValue::GetModified}
-
-\func{bool}{GetModified}{\void}
-
-Returns true if the value was modified since being created
-(or since SetModified was called).
-
-\membersection{wxPropertyValue::GetNext}
-
-\func{wxPropertyValue *}{GetNext}{\void}
-
-Gets the next value in the list (the one after `this').
-
-\membersection{wxPropertyValue::GetStringRepresentation}
-
-\func{wxString}{GetStringRepresentation}{\void}
-
-Gets a string representation of the value.
-
-\membersection{wxPropertyValue::IntegerValue}
-
-\func{long}{IntegerValue}{\void}
-
-Returns the integer value.
-
-\membersection{wxPropertyValue::Insert}
-
-\func{void}{Insert}{\param{wxPropertyValue *}{expr}}
-
-Inserts a property value at the front of a list.
-
-\membersection{wxPropertyValue::IntegerValuePtr}
-
-\func{long *}{IntegerValuePtr}{\void}
-
-Returns the pointer to the integer value.
-
-\membersection{wxPropertyValue::Nth}
-
-\func{wxPropertyValue *}{Nth}{\param{int}{ n}}
-
-Returns the nth value of a list expression (starting from zero).
-
-\membersection{wxPropertyValue::Number}
-
-\func{int}{Number}{\void}
-
-Returns the number of elements in a list expression.
-
-\membersection{wxPropertyValue::RealValue}
-
-\func{float}{RealValue}{\void}
-
-Returns the floating point value.
-
-\membersection{wxPropertyValue::RealValuePtr}
-
-\func{float *}{RealValuePtr}{\void}
-
-Returns the pointer to the floating point value.
-
-\membersection{wxPropertyValue::SetModified}
-
-\func{void}{SetModified}{\param{bool}{ flag}}
-
-Sets the `modified' flag.
-
-\membersection{wxPropertyValue::StringValue}
-
-\func{char *}{StringValue}{\void}
-
-Returns the string value.
-
-\membersection{wxPropertyValue::StringValuePtr}
-
-\func{char **}{StringValuePtr}{\void}
-
-Returns the pointer to the string value.
-
-\membersection{wxPropertyValue::Type}
-
-\func{wxPropertyValueType}{Type}{\void}
-
-Returns the value type.
-
-\membersection{wxPropertyValue::operator $=$}
-
-\func{void}{operator $=$}{\param{const wxPropertyValue\& }{val}}
-
-\func{void}{operator $=$}{\param{const char *}{val}}
-
-\func{void}{operator $=$}{\param{const long }{val}}
-
-\func{void}{operator $=$}{\param{const bool }{val}}
-
-\func{void}{operator $=$}{\param{const float }{val}}
-
-\func{void}{operator $=$}{\param{const char **}{val}}
-
-\func{void}{operator $=$}{\param{const long *}{val}}
-
-\func{void}{operator $=$}{\param{const bool *}{val}}
-
-\func{void}{operator $=$}{\param{const float *}{val}}
-
-Assignment operators.
-
+++ /dev/null
-\section{\class{wxPropertyValidator}}\label{wxpropertyvalidator}
-
-The {\bf wxPropertyValidator} abstract class is the base class for deriving
-validators for properties.
-
-\wxheading{See also}
-
-\helpref{wxPropertyValidator overview}{wxpropertyvalidatoroverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyValidator::wxPropertyValidator}
-
-\func{void}{wxPropertyValidator}{\param{long}{ flags = 0}}
-
-Constructor.
-
-\membersection{wxPropertyValidator::\destruct{wxPropertyValidator}}
-
-\func{void}{\destruct{wxPropertyValidator}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyValidator::GetFlags}
-
-\func{long}{GetFlags}{\void}
-
-Returns the flags for the validator.
-
-\membersection{wxPropertyValidator::GetValidatorProperty}
-
-\func{wxProperty *}{GetValidatorProperty}{\void}
-
-Gets the property for the validator.
-
-\membersection{wxPropertyValidator::SetValidatorProperty}
-
-\func{void}{SetValidatorProperty}{\param{wxProperty *}{property}}
-
-Sets the property for the validator.
-
+++ /dev/null
-\section{\class{wxPropertyView}}\label{wxpropertyview}
-
-The {\bf wxPropertyView} abstract class is the base class for views
-of property sheets, acting as intermediaries between properties and
-actual windows.
-
-\wxheading{See also}
-
-\helpref{wxPropertyView overview}{wxpropertyviewoverview}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxPropertyView::wxPropertyView}
-
-\func{void}{wxPropertyView}{\param{long}{ flags = wxPROP\_BUTTON\_DEFAULT}}
-
-Constructor.
-
-The {\it flags} argument can be a bit list of the following:
-
-\begin{itemize}\itemsep=0pt
-\item wxPROP\_BUTTON\_CLOSE
-\item wxPROP\_BUTTON\_OK
-\item wxPROP\_BUTTON\_CANCEL
-\item wxPROP\_BUTTON\_CHECK\_CROSS
-\item wxPROP\_BUTTON\_HELP
-\item wxPROP\_DYNAMIC\_VALUE\_FIELD
-\item wxPROP\_PULLDOWN
-\end{itemize}
-
-\membersection{wxPropertyView::\destruct{wxPropertyView}}
-
-\func{void}{\destruct{wxPropertyView}}{\void}
-
-Destructor.
-
-\membersection{wxPropertyView::AddRegistry}\label{wxpropertyviewaddregistry}
-
-\func{void}{AddRegistry}{\param{wxPropertyValidatorRegistry *}{registry}}
-
-Adds a registry (list of property validators) the view's list of registries, which is initially empty.
-
-\membersection{wxPropertyView::FindPropertyValidator}\label{wxpropertyviewfindpropertyvalidator}
-
-\func{wxPropertyValidator *}{FindPropertyValidator}{\param{wxProperty *}{property}}
-
-Finds the property validator that is most appropriate to this property.
-
-\membersection{wxPropertyView::GetPropertySheet}\label{wxpropertyviewgetpropertysheet}
-
-\func{wxPropertySheet *}{GetPropertySheet}{\void}
-
-Gets the property sheet for this view.
-
-\membersection{wxPropertyView::GetRegistryList}\label{wxpropertyviewgetregistrylist}
-
-\func{wxList\&}{GetRegistryList}{\void}
-
-Returns a reference to the list of property validator registries.
-
-\membersection{wxPropertyView::OnOk}\label{wxpropertyviewonok}
-
-\func{void}{OnOk}{\void}
-
-Virtual function that will be called when the OK button on the physical window is pressed (if it exists).
-
-\membersection{wxPropertyView::OnCancel}\label{wxpropertyviewoncancel}
-
-\func{void}{OnCancel}{\void}
-
-Virtual function that will be called when the Cancel button on the physical window is pressed (if it exists).
-
-\membersection{wxPropertyView::OnClose}\label{wxpropertyviewonclose}
-
-\func{bool}{OnClose}{\void}
-
-Virtual function that will be called when the physical window is closed. The default implementation returns false.
-
-\membersection{wxPropertyView::OnHelp}\label{wxpropertyviewonhelp}
-
-\func{void}{OnHelp}{\void}
-
-Virtual function that will be called when the Help button on the physical window is pressed (if it exists).
-
-\membersection{wxPropertyView::OnPropertyChanged}\label{wxpropertyviewonpropertychanged}
-
-\func{void}{OnPropertyChanged}{\param{wxProperty *}{property}}
-
-Virtual function called by a view or validator when a property's value changed. Validators
-must be written correctly for this to be called. You can override this function
-to respond immediately to property value changes.
-
-\membersection{wxPropertyView::OnUpdateView}\label{wxpropertyviewonupdateview}
-
-\func{bool}{OnUpdateView}{\void}
-
-Called by the viewed object to update the view. The default implementation just returns
-false.
-
-\membersection{wxPropertyView::SetPropertySheet}\label{wxpropertyviewsetpropertysheet}
-
-\func{void}{SetPropertySheet}{\param{wxPropertySheet *}{sheet}}
-
-Sets the property sheet for this view.
-
-\membersection{wxPropertyView::ShowView}\label{wxpropertyviewshowview}
-
-\func{void}{ShowView}{\param{wxPropertySheet *}{sheet}, \param{wxPanel *}{panel}}
-
-Associates this view with the given panel, and shows the view.
-
\input tvalidat.tex
\input tconstr.tex
\input tsizer.tex
-\input tresourc.tex
\input txrc.tex
\input tscroll.tex
\input tbitmap.tex
+++ /dev/null
-\section{\class{wxTreeLayout}}\label{wxtreelayout}
-
-wxTreeLayout provides layout of simple trees with one root node, drawn left-to-right,
-with user-defined spacing between nodes.
-
-wxTreeLayout is an abstract class that must be subclassed. The programmer
-defines various member functions which will access whatever data structures
-are appropriate for the application, and wxTreeLayout uses these when laying
-out the tree.
-
-Nodes are identified by long integer identifiers. The derived class
-communicates the actual tree structure to wxTreeLayout by defining \helpref{wxTreeLayout::GetChildren}{wxtreelayoutgetchildren}\rtfsp
-and \helpref{wxTreeLayout::GetNodeParent}{wxtreelayoutgetnodeparent} functions.
-
-The application should call \helpref{wxTreeLayout::DoLayout}{wxtreelayoutdolayout} to do the tree
-layout. Depending on how the derived class has been defined, either
-\rtfsp\helpref{wxTreeLayout::Draw}{wxtreelayoutdraw} must be called (for example by the OnPaint member
-of a wxScrolledWindow) or the application-defined drawing code should be called
-as normal.
-
-For example, if you have an image drawing system already defined, you
-may want wxTreeLayout to position existing node images in that system. So you
-just need a way for wxTreeLayout to set the node image positions according to
-the layout algorithm, and the rest will be done by your own image drawing
-system.
-
-The algorithm is due to Gabriel Robins \cite{robins87}, a linear-time
-algorithm originally implemented in LISP for AI applications.
-
-The original algorithm has been modified so that both X and Y planes
-are calculated simultaneously, increasing efficiency slightly. The basic
-code is only a page or so long.
-
-\helponly{Below is the example tree generated by the program test.cc.
-
-\begin{figure}
-$$\image{11cm;0cm}{treetst.ps}$$
-\caption{Example tree}\label{exampletree}
-\end{figure}
-}
-
-\wxheading{Derived from}
-
-wxObject
-
-\wxheading{See also}
-
-\helpref{wxTreeLayoutStored}{wxtreelayoutstored}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxTreeLayout::wxTreeLayout}
-
-\func{}{wxTreeLayout}{\void}
-
-Constructor.
-
-\membersection{wxTreeLayout::ActivateNode}\label{wxtreelayoutactivatenode}
-
-\func{void}{ActivateNode}{\param{long}{ id}, \param{bool }{active}}
-
-Define this so wxTreeLayout can turn nodes on and off for drawing purposes
-(not all nodes may be connected in the tree). See also \helpref{wxTreeLayout::NodeActive}{wxtreelayoutnodeactive}.
-
-\membersection{wxTreeLayout::CalcLayout}
-
-\func{void}{CalcLayout}{\param{long}{ id}, \param{int}{ level}}
-
-Private function for laying out a branch.
-
-\membersection{wxTreeLayout::DoLayout}\label{wxtreelayoutdolayout}
-
-\func{void}{DoLayout}{\param{wxDC\&}{ dc}, \param{long}{ topNode = -1}}
-
-Calculates the layout for the tree, optionally specifying the top node.
-
-\membersection{wxTreeLayout::Draw}\label{wxtreelayoutdraw}
-
-\func{void}{Draw}{\param{wxDC\&}{ dc}}
-
-Call this to let wxTreeLayout draw the tree itself, once the layout has been
-calculated with \helpref{wxTreeLayout::DoLayout}{wxtreelayoutdolayout}.
-
-\membersection{wxTreeLayout::DrawBranch}
-
-\func{void}{DrawBranch}{\param{long}{ from}, \param{long}{ to}, \param{wxDC\&}{ dc}}
-
-Defined by wxTreeLayout to draw an arc between two nodes.
-
-\membersection{wxTreeLayout::DrawBranches}
-
-\func{void}{DrawBranches}{\param{wxDC\&}{ dc}}
-
-Defined by wxTreeLayout to draw the arcs between nodes.
-
-\membersection{wxTreeLayout::DrawNode}
-
-\func{void}{DrawNode}{\param{long}{ id}, \param{wxDC\&}{ dc}}
-
-Defined by wxTreeLayout to draw a node.
-
-\membersection{wxTreeLayout::DrawNodes}
-
-\func{void}{DrawNodes}{\param{wxDC\&}{ dc}}
-
-Defined by wxTreeLayout to draw the nodes.
-
-\membersection{wxTreeLayout::GetChildren}\label{wxtreelayoutgetchildren}
-
-\func{void}{GetChildren}{\param{long}{ id}, \param{wxList \&}{list}}
-
-Must be defined to return the children of node {\it id} in the given list
-of integers.
-
-\membersection{wxTreeLayout::GetNextNode}\label{wxtreelayoutgetnextnode}
-
-\func{long}{GetNextNode}{\param{long}{ id}}
-
-Must be defined to return the next node after {\it id}, so that wxTreeLayout can
-iterate through all relevant nodes. The ordering is not important.
-The function should return -1 if there are no more nodes.
-
-\membersection{wxTreeLayout::GetNodeName}
-
-\constfunc{wxString}{GetNodeName}{\param{long}{ id}}
-
-May optionally be defined to get a node's name (for example if leaving
-the drawing to wxTreeLayout).
-
-\membersection{wxTreeLayout::GetNodeSize}
-
-\constfunc{void}{GetNodeSize}{\param{long}{ id}, \param{long*}{ x}, \param{long*}{ y}}
-
-Can be defined to indicate a node's size, or left to wxTreeLayout to use the
-name as an indication of size.
-
-\membersection{wxTreeLayout::GetNodeParent}\label{wxtreelayoutgetnodeparent}
-
-\constfunc{long}{GetNodeParent}{\param{long}{ id}}
-
-Must be defined to return the parent node of {\it id}.
-The function should return -1 if there is no parent.
-
-\membersection{wxTreeLayout::GetNodeX}
-
-\constfunc{long}{GetNodeX}{\param{long}{ id}}
-
-Must be defined to return the current X position of the node. Note that
-coordinates are assumed to be at the top-left of the node so some conversion
-may be necessary for your application.
-
-\membersection{wxTreeLayout::GetNodeY}
-
-\constfunc{long}{GetNodeY}{\param{long}{ id}}
-
-Must be defined to return the current Y position of the node. Note that
-coordinates are assumed to be at the top-left of the node so some conversion
-may be necessary for your application.
-
-\membersection{wxTreeLayout::GetLeftMargin}
-
-\constfunc{long}{GetLeftMargin}{\void}
-
-Gets the left margin set with \helpref{wxTreeLayout::SetMargins}{wxtreelayoutsetmargins}.
-
-\membersection{wxTreeLayout::GetOrientation}
-
-\constfunc{bool}{GetOrientation}{\void}
-
-Gets the orientation: true means top-to-bottom, false means left-to-right (the default).
-
-\membersection{wxTreeLayout::GetTopMargin}
-
-\constfunc{long}{GetTopMargin}{\void}
-
-Gets the top margin set with \helpref{wxTreeLayout::SetMargins}{wxtreelayoutsetmargins}.
-
-\membersection{wxTreeLayout::GetTopNode}
-
-\constfunc{long}{GetTopNode}{\void}
-
-wxTreeLayout calls this to get the top of the tree. Don't redefine this; call
-\rtfsp\helpref{wxTreeLayout::SetTopNode}{wxtreelayoutsettopnode} instead before calling \helpref{wxTreeLayout::DoLayout}{wxtreelayoutdolayout}.
-
-\membersection{wxTreeLayout::GetXSpacing}
-
-\constfunc{long}{GetXSpacing}{\void}
-
-Gets the horizontal spacing between nodes.
-
-\membersection{wxTreeLayout::GetYSpacing}
-
-\constfunc{long}{GetYSpacing}{\void}
-
-Gets the vertical spacing between nodes.
-
-\membersection{wxTreeLayout::Initialize}
-
-\func{void}{Initialize}{\void}
-
-Initializes wxTreeLayout. Call from application or overridden {\bf Initialize}
-or constructor.
-
-\membersection{wxTreeLayout::NodeActive}\label{wxtreelayoutnodeactive}
-
-\func{bool}{NodeActive}{\param{long}{ id}}
-
-Define this so wxTreeLayout can know which nodes are to be drawn (not all
-nodes may be connected in the tree). See also \helpref{wxTreeLayout::ActivateNode}{wxtreelayoutactivatenode}.
-
-\membersection{wxTreeLayout::SetNodeName}
-
-\func{void}{SetNodeName}{\param{long}{ id}, \param{const wxString\& }{ name}}
-
-May optionally be defined to set a node's name.
-
-\membersection{wxTreeLayout::SetNodeX}
-
-\func{void}{SetNodeX}{\param{long}{ id}, \param{long}{ x}}
-
-Must be defined to set the current X position of the node. Note that
-coordinates are assumed to be at the top-left of the node so some conversion
-may be necessary for your application.
-
-\membersection{wxTreeLayout::SetNodeY}
-
-\func{void}{SetNodeY}{\param{long}{ id}, \param{long}{ y}}
-
-Must be defined to set the current Y position of the node. Note that
-coordinates are assumed to be at the top-left of the node so some conversion
-may be necessary for your application.
-
-\membersection{wxTreeLayout::SetOrientation}
-
-\func{void}{SetOrientation}{\param{bool}{ orientation}}
-
-Sets the tree orientation: true means top-to-bottom, false means left-to-right (the default).
-
-\membersection{wxTreeLayout::SetTopNode}\label{wxtreelayoutsettopnode}
-
-\func{void}{SetTopNode}{\param{long}{ id}}
-
-Call this to identify the top of the tree to wxTreeLayout.
-
-\membersection{wxTreeLayout::SetSpacing}
-
-\func{void}{SetSpacing}{\param{long}{ x}, \param{long}{ y}}
-
-Sets the horizontal and vertical spacing between nodes in the tree.
-
-\membersection{wxTreeLayout::SetMargins}\label{wxtreelayoutsetmargins}
-
-\func{void}{SetMargins}{\param{long}{ x}, \param{long}{ y}}
-
-Sets the left and top margins of the whole tree.
-
-\section{\class{wxTreeLayoutStored}}\label{wxtreelayoutstored}
-
-wxTreeLayoutStored provides storage for node labels, position and client data. It also provides hit-testing
-(which node a mouse event occurred on). It is usually a more convenient class to use than wxTreeLayout.
-
-\wxheading{Derived from}
-
-\helpref{wxTreeLayout}{wxtreelayout}\\
-\helpref{wxObject}{wxobject}
-
-\wxheading{See also}
-
-\helpref{wxTreeLayout}{wxtreelayout}
-
-\latexignore{\rtfignore{\wxheading{Members}}}
-
-\membersection{wxTreeLayoutStored::wxTreeLayoutStored}
-
-\func{}{wxTreeLayoutStored}{\param{int }{noNodes = 200}}
-
-Constructor. Specify the maximum number of nodes to be allocated.
-
-\membersection{wxTreeLayoutStored::AddChild}\label{wxtreelayoutstoredaddchild}
-
-\func{long}{AddChild}{\param{const wxString\&}{ name}, \param{const wxString\&}{ parent = ""}}
-
-Adds a child with a given parent, returning the node id.
-
-\membersection{wxTreeLayoutStored::GetClientData}\label{wxtreelayoutstoredgetclientdata}
-
-\constfunc{long}{GetClientData}{\param{long}{ id}}
-
-Gets the client data for the given node.
-
-\membersection{wxTreeLayoutStored::GetNode}\label{wxtreelayoutstoredgetnode}
-
-\constfunc{wxStoredNode*}{GetNode}{\param{long}{ id}}
-
-Returns the wxStoredNode object for the given node id.
-
-\membersection{wxTreeLayoutStored::GetNodeCount}\label{wxtreelayoutstoredgetnodecount}
-
-\constfunc{int}{GetNodeCount}{\void}
-
-Returns the current number of nodes.
-
-\membersection{wxTreeLayoutStored::GetNumNodes}\label{wxtreelayoutstoredgetnumnodes}
-
-\constfunc{int}{GetNumNodes}{\void}
-
-Returns the maximum number of nodes.
-
-\membersection{wxTreeLayoutStored::HitTest}\label{wxtreelayoutstoredhittest}
-
-\func{wxString}{HitTest}{\param{wxMouseEvent\&}{ event}, \param{wxDC\& }{dc}}
-
-Returns a string with the node name corresponding to the position of the mouse event, or the empty string if no node
-was detected.
-
-\membersection{wxTreeLayoutStored::NameToId}\label{wxtreelayoutstorednametoid}
-
-\func{long}{NameToId}{\param{const wxString\&}{ name}}
-
-Returns the id for the given node name, or -1 if there was no such node.
-
-\membersection{wxTreeLayoutStored::SetClientData}\label{wxtreelayoutstoredsetclientdata}
-
-\func{void}{SetClientData}{\param{long}{ id}, \param{long}{ clientData}}
-
-Sets client data for the given node.
-
+++ /dev/null
-\section{The wxWindows resource system}\label{resourceformats}
-
-wxWindows has an optional {\it resource file} facility,
-which allows separation of dialog, menu, bitmap and icon specifications
-from the application code.
-
-{\bf NOTE:} this format is now deprecated in favour of the XML-based \helpref{XRC resource system}{xrcoverview}.
-However it is still available if wxUSE\_RESOURCES is enabled.
-
-The format is similar in principle to the Windows resource file (whose ASCII form is
-suffixed .RC and whose binary form is suffixed .RES). The wxWindows resource
-file is currently ASCII-only, suffixed .WXR. Note that under Windows,
-the .WXR file does not {\it replace} the native Windows resource file,
-it merely supplements it. There is no existing native resource format in X
-(except for the defaults file, which has limited expressive power).
-
-For details of functions for manipulating resource files and loading
-user interface elements, see \helpref{wxWindows resource functions}{resourcefuncs}.
-
-You can use Dialog Editor to create resource files. Unfortunately neither
-Dialog Editor nor the .WXR format currently cover all wxWindows controls;
-some are missing, such as wxSpinCtrl, wxSpinButton, wxListCtrl, wxTreeCtrl and others.
-
-Note that in later versions of wxWindows, this resource format will be replaced
-by XML specifications that can also include sizers.
-
-\subsection{The format of a .WXR file}
-
-A wxWindows resource file may look a little odd at first. It is C++
-compatible, comprising mostly of static string variable declarations with
-wxExpr syntax within the string.
-
-Here's a sample .WXR file:
-
-\begin{verbatim}
-/*
- * wxWindows Resource File
- *
- */
-
-#include "noname.ids"
-
-static char *my_resource = "bitmap(name = 'my_resource',\
- bitmap = ['myproject', wxBITMAP_TYPE_BMP_RESOURCE, 'WINDOWS'],\
- bitmap = ['myproject.xpm', wxBITMAP_TYPE_XPM, 'X']).";
-
-static char *menuBar11 = "menu(name = 'menuBar11',\
- menu = \
- [\
- ['&File', 1, '', \
- ['&Open File', 2, 'Open a file'],\
- ['&Save File', 3, 'Save a file'],\
- [],\
- ['E&xit', 4, 'Exit program']\
- ],\
- ['&Help', 5, '', \
- ['&About', 6, 'About this program']\
- ]\
- ]).";
-
-static char *project_resource = "icon(name = 'project_resource',\
- icon = ['project', wxBITMAP_TYPE_ICO_RESOURCE, 'WINDOWS'],\
- icon = ['project_data', wxBITMAP_TYPE_XBM, 'X']).";
-
-static char *panel3 = "dialog(name = 'panel3',\
- style = '',\
- title = 'untitled',\
- button_font = [14, 'wxSWISS', 'wxNORMAL', 'wxBOLD', 0],\
- label_font = [10, 'wxSWISS', 'wxNORMAL', 'wxNORMAL', 0],\
- x = 0, y = 37, width = 292, height = 164,\
- control = [1000, wxButton, 'OK', '', 'button5', 23, 34, -1, -1, 'my_resource'],\
- control = [1001, wxStaticText, 'A Label', '', 'message7', 166, 61, -1, -1, 'my_resource'],\
- control = [1002, wxTextCtrl, 'Text', 'wxTE_MULTITEXT', 'text8', 24, 110, -1, -1]).";
-\end{verbatim}
-
-As you can see, C++-style comments are allowed, and apparently include files
-are supported too: but this is a special case, where the included file
-is a file of defines shared by the C++ application code and resource file
-to relate identifiers (such as FILE\_OPEN) to integers.
-
-Each {\it resource object} is of standard \helpref{wxExpr}{wxexpr} syntax, that is,
-an object name such as {\bf dialog} or {\bf icon}, then an open
-parenthesis, a list of comma-delimited attribute/value pairs, a closing
-parenthesis, and a full stop. Backslashes are required to escape newlines,
-for the benefit of C++ syntax. If double quotation marks are used to
-delimit strings, they need to be escaped with backslash within a C++ string
-(so it is easier to use single quotation marks instead).
-
-\normalbox{{\it A note on string syntax:} A string that begins with
-an alphabetic character, and contains only alphanumeric characters,
-hyphens and underscores, need not be quoted at all. Single quotes and double
-quotes may be used to delimit more complex strings. In fact, single-quoted
-and no-quoted strings are actually called {\it words}, but are treated
-as strings for the purpose of the resource system.}
-
-A resource file like this is typically included in the application main file,
-as if it were a normal C++ file. This eliminates the need for a separate
-resource file to be distributed alongside the executable. However, the
-resource file can be dynamically loaded if desired (useful for non-C++
-languages such as Python).
-
-Once included, the resources need to be `parsed' (interpreted), because
-so far the data is just a number of static string variables. The function\rtfsp
-{\bf ::wxResourceParseData} is called early on in initialization of the application
-(usually in {\bf wxApp::OnInit}) with a variable as argument. This may need to be
-called a number of times, one for each variable. However, more than one
-resource `object' can be stored in one string variable at a time, so you can
-get all your resources into one variable if you want to.
-
-{\bf ::wxResourceParseData} parses the contents of the resource, ready for use
-by functions such as {\bf ::wxResourceCreateBitmap} and {\bf wxPanel::LoadFromResource}.
-
-If a wxWindows resource object (such as a bitmap resource) refers to a
-C++ data structure, such as static XPM data, a further call ({\bf ::wxResourceRegisterBitmapData}) needs
-to be made on initialization to tell
-wxWindows about this data. The wxWindows resource object will refer to a
-string identifier, such as `project\_data' in the example file above.
-This identifier will be looked up in a table to get the C++ static data
-to use for the bitmap or icon.
-
-In the C++ fragment below, the WXR resource file is included,
-and appropriate resource initialization is carried out in {\bf OnInit}.
-Note that at this stage, no actual wxWindows dialogs, menus, bitmaps or
-icons are created; their `templates' are merely being set up for later
-use.
-
-\begin{verbatim}
-/*
- * File: project.cpp
- * Purpose: main application module
- */
-
-#include "wx/wx.h"
-#include "project.h"
-
-// Includes the dialog, menu etc. resources
-#include "project.wxr"
-
-// Includes XPM data
-#include "project.xpm"
-
-IMPLEMENT_APP(AppClass)
-
-// Called to initialize the program
-bool AppClass::OnInit()
-{
- wxResourceRegisterBitmapData("project_data", project_bits, project_width, project_height);
-
- wxResourceParseData(menuBar11);
- wxResourceParseData(my_resource);
- wxResourceParseData(project_resource);
- wxResourceParseData(panel3);
- ...
-
- return true;
-}
-\end{verbatim}
-
-The following code shows a dialog:
-
-\begin{verbatim}
- // project.wxr contains dialog1
- MyDialog *dialog = new MyDialog;
- if (dialog->LoadFromResource(this, "dialog1"))
- {
- wxTextCtrl *text = (wxTextCtrl *)wxFindWindowByName("text3", dialog);
- if (text)
- text->SetValue("wxWindows resource demo");
- dialog->ShowModal();
- }
- dialog->Destroy();
-\end{verbatim}
-
-Please see also the resource sample.
-
-\subsection{Dialog resource format}
-
-A dialog resource object may be used for either panels or dialog boxes, and
-consists of the following attributes. In the following, a {\it font specification}\rtfsp
-is a list consisting of point size, family, style, weight, underlined, optional facename.
-
-\begin{twocollist}\itemsep=0pt
-\twocolitemruled{Attribute}{Value}
-\twocolitem{id}{The integer identifier of the resource.}
-\twocolitem{name}{The name of the resource.}
-\twocolitem{style}{Optional dialog box or panel window style.}
-\twocolitem{title}{The title of the dialog box (unused if a panel).}.
-\twocolitem{modal}{Whether modal: 1 if modal, 0 if modeless, absent if a panel resource.}
-\twocolitem{use\_dialog\_units}{If 1, use dialog units (dependent on the dialog font size) for control sizes and positions.}
-\twocolitem{use\_system\_defaults}{If 1, override colours and fonts to use system settings instead.}
-\twocolitem{button\_font}{The font used for control buttons: a list comprising point size (integer),
-family (string), font style (string), font weight (string) and underlining (0 or 1).}
-\twocolitem{label\_font}{The font used for control labels: a list comprising point size (integer),
-family (string), font style (string), font weight (string) and underlining (0 or 1). Now obsolete; use button\_font instead.}
-\twocolitem{x}{The x position of the dialog or panel.}
-\twocolitem{y}{The y position of the dialog or panel.}
-\twocolitem{width}{The width of the dialog or panel.}
-\twocolitem{height}{The height of the dialog or panel.}
-\twocolitem{background\_colour}{The background colour of the dialog or panel.}
-\twocolitem{label\_colour}{The default label colour for the children of the dialog or panel. Now obsolete; use button\_colour instead.}
-\twocolitem{button\_colour}{The default button text colour for the children of the dialog or panel.}
-\end{twocollist}
-
-Then comes zero or more attributes named `control' for each control
-(panel item) on the dialog or panel. The value is a list of further
-elements. In the table below, the names in the first column correspond to
-the first element of the value list, and the second column details the
-remaining elements of the list. Note that titles for some controls are obsolete
-(they don't have titles), but the syntax is retained for backward compatibility.
-
-\begin{twocollist}\itemsep=0pt
-\twocolitemruled{Control}{Values}
-\twocolitem{wxButton}{id (integer), title (string), window style (string), name (string), x, y, width, height, button bitmap resource (optional string), button font spec}
-\twocolitem{wxCheckBox}{id (integer), title (string), window style (string), name (string), x, y, width, height, default value (optional integer, 1 or 0), label font spec}
-\twocolitem{wxChoice}{id (integer), title (string), window style (string), name (string), x, y, width, height, values (optional list of strings), label font spec, button font spec}
-\twocolitem{wxComboBox}{id (integer), title (string), window style (string), name (string), x, y, width, height, default text value, values (optional list of strings), label font spec, button font spec}
-\twocolitem{wxGauge}{id (integer), title (string), window style (string), name (string), x, y, width, height, value (optional integer), range (optional integer), label font spec, button font spec}
-\twocolitem{wxStaticBox}{id (integer), title (string), window style (string), name (string), x, y, width, height, label font spec}
-\twocolitem{wxListBox}{id (integer), title (string), window style (string), name (string), x, y, width, height, values (optional list of strings), multiple (optional string, wxSINGLE or wxMULTIPLE),
-label font spec, button font spec}
-\twocolitem{wxStaticText}{id (integer), title (string), window style (string), name (string), x, y, width, height, message bitmap resource (optional string), label font spec}
-\twocolitem{wxRadioBox}{id (integer), title (string), window style (string), name (string), x, y, width, height, values (optional list of strings), number of rows or cols,
-label font spec, button font spec}
-\twocolitem{wxRadioButton}{id (integer), title (string), window style (string), name (string), x, y, width, height, default value (optional integer, 1 or 0), label font spec}
-\twocolitem{wxScrollBar}{id (integer), title (string), window style (string), name (string), x, y, width, height, value (optional integer),
-page length (optional integer), object length (optional integer), view length (optional integer)}
-\twocolitem{wxSlider}{id (integer), title (string), window style (string), name (string), x, y, width, height, value (optional integer), minimum (optional integer), maximum (optional integer),
-label font spec, button font spec}
-\twocolitem{wxTextCtrl}{id (integer), title (string), window style (string), name (string), x, y, width, height, default value (optional string),
-label font spec, button font spec}
-\end{twocollist}
-
-\subsection{Menubar resource format}
-
-A menubar resource object consists of the following attributes.
-
-\begin{twocollist}\itemsep=0pt
-\twocolitemruled{Attribute}{Value}
-\twocolitem{name}{The name of the menubar resource.}
-\twocolitem{menu}{A list containing all the menus, as detailed below.}
-\end{twocollist}
-
-The value of the {\bf menu} attribute is a list of menu item specifications, where each menu
-item specification is itself a list comprising:
-
-\begin{itemize}\itemsep=0pt
-\item title (a string)
-\item menu item identifier (a string or non-zero integer, see below)
-\item help string (optional)
-\item 0 or 1 for the `checkable' parameter (optional)
-\item optionally, further menu item specifications if this item is a pulldown menu.
-\end{itemize}
-
-If the menu item specification is the empty list ([]), this is interpreted as a menu separator.
-
-If further (optional) information is associated with each menu item in a future release of wxWindows,
-it will be placed after the help string and before the optional pulldown menu specifications.
-
-Note that the menu item identifier must be an integer if the resource is being
-included as C++ code and then parsed on initialisation. Unfortunately,\rtfsp
-\#define substitution is not performed inside strings, and
-therefore the program cannot know the mapping. However, if the .WXR file
-is being loaded dynamically, wxWindows will attempt to replace string
-identifiers with \#defined integers, because it is able to parse
-the included \#defines.
-
-\subsection{Bitmap resource format}
-
-A bitmap resource object consists of a name attribute, and one or more {\bf bitmap} attributes.
-There can be more than one of these to allow specification of bitmaps that are optimum for the
-platform and display.
-
-\begin{itemize}\itemsep=0pt
-\item Bitmap name or filename.
-\item Type of bitmap; for example, wxBITMAP\_TYPE\_BMP\_RESOURCE. See class reference under {\bf wxBitmap} for
-a full list).
-\item Platform this bitmap is valid for; one of WINDOWS, X, MAC and ANY.
-\item Number of colours (optional).
-\item X resolution (optional).
-\item Y resolution (optional).
-\end{itemize}
-
-\subsection{Icon resource format}
-
-An icon resource object consists of a name attribute, and one or more {\bf icon} attributes.
-There can be more than one of these to allow specification of icons that are optimum for the
-platform and display.
-
-\begin{itemize}\itemsep=0pt
-\item Icon name or filename.
-\item Type of icon; for example, wxBITMAP\_TYPE\_ICO\_RESOURCE. See class reference under {\bf wxBitmap} for
-a full list).
-\item Platform this bitmap is valid for; one of WINDOWS, X, MAC and ANY.
-\item Number of colours (optional).
-\item X resolution (optional).
-\item Y resolution (optional).
-\end{itemize}
-
-\subsection{Resource format design issues}
-
-The .WXR file format is a recent addition and subject to change.
-The use of an ASCII resource file format may seem rather inefficient, but this
-choice has a number of advantages:
-
-\begin{itemize}\itemsep=0pt
-\item Since it is C++ compatible, it can be included into an application's source code,
-eliminating the problems associated with distributing a separate resource file
-with the executable. However, it can also be loaded dynamically from a file, which will be required
-for non-C++ programs that use wxWindows.
-\item No extra binary file format and separate converter need be maintained for the wxWindows project
-(although others are welcome to add the equivalent of the Windows `rc' resource
-parser and a binary format).
-\item It would be difficult to append a binary resource component onto an executable
-in a portable way.
-\item The file format is essentially the \helpref{wxExpr}{wxexpr} object format, for which
-a parser already exists, so parsing is easy. For those programs that use wxExpr
-anyway, the size overhead of the parser is minimal.
-\end{itemize}
-
-The disadvantages of the approach include:
-
-\begin{itemize}\itemsep=0pt
-\item Parsing adds a small execution overhead to program initialization.
-\item Under 16-bit Windows especially, global data is at a premium.
-Using a .RC resource table for some wxWindows resource data may be a partial solution,
-although .RC strings are limited to 255 characters.
-\item Without a resource preprocessor, it is not possible to substitute integers
-for identifiers (so menu identifiers have to be written as integers in the resource
-object, in addition to providing \#defines for application code convenience).
-\end{itemize}
-
-\subsection{Compiling the resource system}
-
-To enable the resource system, set {\bf wxUSE\_WX\_RESOURCES} to 1 in setup.h.
-
See \helpref{wxWindow::SetAutoLayout}{wxwindowsetautolayout}: when auto
layout is on, this function gets called automatically when the window is resized.
-\membersection{wxWindow::LoadFromResource}\label{wxwindowloadfromresource}
-
-\func{virtual bool}{LoadFromResource}{\param{wxWindow* }{parent},\rtfsp
-\param{const wxString\& }{resourceName}, \param{const wxResourceTable* }{resourceTable = NULL}}
-
-Loads a panel or dialog from a resource file.
-
-\wxheading{Parameters}
-
-\docparam{parent}{Parent window.}
-
-\docparam{resourceName}{The name of the resource to load.}
-
-\docparam{resourceTable}{The resource table to load it from. If this is NULL, the
-default resource table will be used.}
-
-\wxheading{Return value}
-
-{\tt true} if the operation succeeded, otherwise {\tt false}.
-
\membersection{wxWindow::Lower}\label{wxwindowlower}
\func{void}{Lower}{\void}
projects / wxWidgets.git / commitdiff
