Doc corrections

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@25909 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Julian Smart
2004-02-22 01:16:32 +00:00
parent 40126b09cc
commit d2c2afc91b
46 changed files with 127 additions and 135 deletions

View File

@@ -32,7 +32,6 @@ a reference to your application object) to be visible to other files.
\latexignore{\rtfignore{\wxheading{Members}}}
\membersection{wxApp::wxApp}
\func{void}{wxApp}{\void}
@@ -345,7 +344,7 @@ work and, in fact, probably won't.
\wxheading{See also}
\helpref{wxHandleFatalExcetions}{wxhandlefatalexceptions}
\helpref{wxHandleFatalExceptions}{wxhandlefatalexceptions}
%% VZ: the wxApp event handler are private and should not be documented here!
%%
@@ -455,10 +454,7 @@ Under Windows, OnQueryEndSession is called in response to the WM\_QUERYENDSESSIO
\wxheading{See also}
\helpref{wxWindow::Close}{wxwindowclose},\rtfsp
\helpref{wxCloseEvent}{wxcloseevent}
%% GD: OnXXX functions are not documented
%%\helpref{wxApp::OnEndSession}{wxapponendsession}
\helpref{wxCloseEvent}{wxcloseevent}\rtfsp
\membersection{wxApp::OnRun}\label{wxapponrun}
@@ -472,7 +468,6 @@ the last frame has been deleted and
\helpref{GetExitOnFrameDelete}{wxappgetexitonframedelete} flag is \true (this
is the default).
\membersection{wxApp::OnUnhandledException}\label{wxapponunhandledexception}
\func{virtual void}{OnUnhandledException}{\void}
@@ -484,7 +479,6 @@ Note that the exception type is lost by now, so if you want to really handle
the exception you should override \helpref{OnRun()}{wxapponrun} and put a
try/catch clause around the call to the base class version there.
\membersection{wxApp::ProcessMessage}\label{wxappprocessmessage}
\func{bool}{ProcessMessage}{\param{WXMSG *}{msg}}

View File

@@ -423,7 +423,7 @@ as
\begin{verbatim}
wxWindow *my_window = (wxWindow*) NULL;
\end{verbatim}
}
}%
It is recommended to adhere to this in all code using wxWindows as
this make the code (a bit) more portable.
@@ -507,7 +507,6 @@ Help files. In many cases, you may wish to use the wxWindows HTML
Help classes from within your application, but this provides a
handy stand-alone viewer. See \helpref{wxHTML Notes}{wxhtml} for more details.
You can find it in {\tt samples/html/helpview}.
\item[{\bf Tex2RTF}]
Supplied with wxWindows is a utility called Tex2RTF for converting\rtfsp
\LaTeX\ manuals HTML, MS HTML Help, wxHTML Help, RTF, and Windows
@@ -515,18 +514,15 @@ Help RTF formats. Tex2RTF is used for the wxWindows manuals and can be used inde
by authors wishing to create on-line and printed manuals from the same\rtfsp
\LaTeX\ source. Please see the separate documentation for Tex2RTF.
You can find it under {\tt utils/tex2rtf}.
\item[{\bf Helpgen}]
Helpgen takes C++ header files and generates a Tex2RTF-compatible
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.
Helpgen can be found in {\tt utils/HelpGen}.
\item[{\bf Emulator}]
Xnest-based display emulator for X11-based PDA applications. On some
systems, the Xnest window does not synchronise with the
'skin' window. This program can be found in {\tt utils/emulator}.
\item[{\bf Configuration Tool}]
The wxWindows Configuration Tool is a work in progress
intended to make it easier to configure wxWindows
@@ -535,46 +531,37 @@ eventually generate makefile config files. Invoking compilers is
also on the cards. Since configurations are
handled one at a time, the tool is of limited used until further
development can be done. The program can be found in {\tt utils/configtool}.
\item[{\bf XRC resource system}]
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}.
For more information, see the \helpref{XML-based resource system overview}{xrcoverview}.
\item[{\bf Object Graphics Library}]
OGL defines an API for applications that need to display objects connected by lines.
The objects can be moved around and interacted with.
You can find this in {\tt contrib/src/ogl}, {\tt contrib/include/wx/ogl}, and {\tt contrib/samples/ogl}.
\item[{\bf Frame Layout library}]
FL provides sophisticated pane dragging and docking facilities.
You can find this in {\tt contrib/src/fl}, {\tt contrib/include/wx/fl}, and {\tt contrib/samples/fl}.
\item[{\bf Gizmos library}]
Gizmos is a collection of useful widgets and other classes. Classes include wxLEDNumberCtrl,
wxEditableListBox, wxMultiCellCanvas.
You can find this in {\tt contrib/src/gizmos}, {\tt contrib/include/wx/gizmos}, and {\tt contrib/samples/gizmos}.
\item[{\bf Net library}]
Net is a collection of very simple mail and web related classes. Currently
there is only wxEmail, which makes it easy to send email messages via MAPI on Windows or sendmail on Unix.
You can find this in {\tt contrib/src/net} and {\tt contrib/include/wx/net}.
\item[{\bf Animate library}]
Animate allows you to load animated GIFs and play them on a window. The library can be extended
to use other animation formats.
You can find this in {\tt contrib/src/animate}, {\tt contrib/include/wx/animate}, and {\tt contrib/samples/animate}.
\item[{\bf MMedia library}]
Mmedia supports a variety of multimedia functionality. The status of this library is currently unclear.
You can find this in {\tt contrib/src/mmedia}, {\tt contrib/include/wx/mmedia}, and {\tt contrib/samples/mmedia}.
\item[{\bf Styled Text Control library}]
STC is a wrapper around Scintilla, a syntax-highlighting text editor.
You can find this in {\tt contrib/src/stc}, {\tt contrib/include/wx/stc}, and {\tt contrib/samples/stc}.
\item[{\bf Plot}]
Plot is a simple curve plotting library.
You can find this in {\tt contrib/src/plot}, {\tt contrib/include/wx/plot}, and {\tt contrib/samples/plot}.

View File

@@ -342,3 +342,4 @@
\input xmlresh.tex
\input zipstrm.tex
\input strmzlib.tex

View File

@@ -37,7 +37,7 @@ days added will be $7*\hbox{weeks} + \hbox{days}$! See also GetTotalDays()
function.
Equality operators are defined for wxDateSpans. Two datespans are equal if
and only if they both give the same target date when added to {\bf every}
and only if they both give the same target date when added to {\bf every}\rtfsp
source date. Thus wxDateSpan::Months(1) is not equal to wxDateSpan::Days(30),
because they don't give the same date when added to 1 Feb. But
wxDateSpan::Days(14) is equal to wxDateSpan::Weeks(2)

View File

@@ -245,8 +245,7 @@ values were correct as constructors can not return an error code.
\helpref{SetSecond}{wxdatetimesetsecond}\\
\helpref{SetMillisecond}{wxdatetimesetmillisecond}\\
\helpref{operator$=$(time\_t)}{wxdatetimeoperatoreqtimet}\\
\helpref{operator$=$(struct tm)}{wxdatetimeoperatoreqtm}
%\helpref{operator$=$(struct Tm)}{wxdatetimeoperatortm2}
\helpref{operator$=$(struct tm)}{wxdatetimeoperatoreqtm}\rtfsp
\membersection{Accessors}

View File

@@ -26,7 +26,8 @@ frames.
Note that the modal dialog is one of the very few examples of
wxWindow-derived objects which may be created on the stack and not on the heap.
In other words, although this code snippet
In other words, although this code snippet:
\begin{verbatim}
void AskUser()
{
@@ -38,8 +39,10 @@ In other words, although this code snippet
dlg->Destroy();
}
\end{verbatim}
works, you can also achieve the same result by using a simpler code fragment
below:
\begin{verbatim}
void AskUser()
{

View File

@@ -18,7 +18,7 @@ hierarchy, and optionally, a \helpref{wxChoice}{wxchoice} window containing a li
\wxheading{Window styles}
\twocolwidtha{5cm}
\twocolwidtha{7cm}
\begin{twocollist}
\twocolitem{\indexit{wxDIRCTRL\_DIR\_ONLY}}{Only show directories, and not files.}
\twocolitem{\indexit{wxDIRCTRL\_3D\_INTERNAL}}{Use 3D borders for internal controls.}

View File

@@ -125,7 +125,8 @@ member to return a new view instance on demand.
either {\tt Wx::ClassInfo} objects or strings which contain the name
of the perl packages which are to be used as {\tt Wx::Document} and
{\tt Wx::View} classes (they must have a constructor named {\tt
new}):\par
new}):
\indented{2cm}{\begin{twocollist}
\twocolitem{{\bf Wx::DocTemplate->new( docmgr, descr, filter, dir,
ext, docTypeName, viewTypeName, docClassInfo, viewClassInfo, flags

View File

@@ -30,7 +30,6 @@ function that takes a wxDropFilesEvent argument.
\wxheading{See also}
%\helpref{wxWindow::OnDropFiles}{wxwindowondropfiles},
\helpref{Event handling overview}{eventhandlingoverview}
\latexignore{\rtfignore{\wxheading{Members}}}

View File

@@ -99,6 +99,7 @@ Returns \true if the library was successfully loaded, \false otherwise.
Loads DLL with the given \arg{name} into memory. The \arg{flags} argument can
be a combination of the following bits:
\begin{twocollist}
\twocolitem{wxDL\_LAZY}{equivalent of RTLD\_LAZY under Unix, ignored elsewhere}
\twocolitem{wxDL\_NOW}{equivalent of RTLD\_NOW under Unix, ignored elsewhere}

View File

@@ -91,6 +91,7 @@ derived from them) are ever posted.
All wxWindows events implement a copy constructor, so the easiest way of
implementing the Clone function is to implement a copy constructor for
a new event (call it MyEvent) and then define the Clone function like this:
\begin{verbatim}
wxEvent *Clone(void) const { return new MyEvent(*this); }
\end{verbatim}

View File

@@ -73,7 +73,7 @@ The rules for determining if the file name is absolute or relative also depends
on the file name format and the only portable way to answer to this question is
to use \helpref{IsAbsolute}{wxfilenameisabsolute} method. To ensure that the
filename is absolute you may use \helpref{MakeAbsolute}{wxfilenamemakeabsolute}.
There is also an inverse function
There is also an inverse function
\helpref{MakeRelativeTo}{wxfilenamemakerelativeto} which undoes what
\helpref{Normalize(wxPATH\_NORM\_DOTS)}{wxfilenamenormalize} does.
@@ -645,6 +645,7 @@ variables will be expanded in it.
\docparam{flags}{The kind of normalization to do with the file name. It can be
any or-combination of the following constants:
\begin{twocollist}
\twocolitem{{\bf wxPATH\_NORM\_ENV\_VARS}}{replace env vars with their values}
\twocolitem{{\bf wxPATH\_NORM\_DOTS}}{squeeze all .. and . and prepend cwd}
@@ -655,7 +656,7 @@ any or-combination of the following constants:
\twocolitem{{\bf wxPATH\_NORM\_SHORTCUT}}{resolve if it is a shortcut (Windows only)}
\twocolitem{{\bf wxPATH\_NORM\_ALL}}{all of previous flags except \texttt{wxPATH\_NORM\_CASE}}
\end{twocollist}
}
}%
\docparam{cwd}{If not empty, this directory will be used instead of current
working directory in normalization.}

View File

@@ -65,7 +65,7 @@ commands change the path to "dir/subdir/":
\begin{verbatim}
ChangePathTo("dir/subdir/xh.htm");
ChangePathTo("dir/subdir", true);
C hangePathTo("dir/subdir/", true);
ChangePathTo("dir/subdir/", true);
\end{verbatim}
\wxheading{Parameters}

View File

@@ -20,6 +20,7 @@ You can retrieve the current system font settings with \helpref{wxSystemSettings
\wxheading{Constants}
The font flags which can be used during the font creation are:
\begin{verbatim}
enum
{
@@ -45,6 +46,7 @@ enum
\end{verbatim}
The known font encodings are:
\begin{verbatim}
enum wxFontEncoding
{

View File

@@ -51,7 +51,7 @@ caption. When pressed, Windows will go into a context-sensitive help mode and wx
a wxEVT\_HELP event if the user clicked on an application window. {\it Note} that this is an extended
style and must be set by calling \helpref{SetExtraStyle}{wxwindowsetextrastyle} before Create is called (two-step construction).
You cannot use this style together with wxMAXIMIZE\_BOX or wxMINIMIZE\_BOX, so
you should use
you should use\rtfsp
{\tt wxDEFAULT\_FRAME\_STYLE \& ~ (wxMINIMIZE\_BOX | wxMAXIMIZE\_BOX)} for the
frames having this style (the dialogs don't have a minimize or a maximize box by
default)}

View File

@@ -6,8 +6,6 @@ The functions and macros defined in wxWindows are described here: you can
either look up a function using the alphabetical listing of them or find it in
the corresponding topic.
\section{Alphabetical functions and macros list}
\helpref{CLASSINFO}{classinfo}\\
@@ -581,7 +579,7 @@ single string.}
array, any additional ones are the command parameters and the array must be
terminated with a NULL pointer.}
\docparam{flags}{Combination of bit masks {\tt wxEXEC\_ASYNC},
\docparam{flags}{Combination of bit masks {\tt wxEXEC\_ASYNC},\rtfsp
{\tt wxEXEC\_SYNC} and {\tt wxEXEC\_NOHIDE}}
\docparam{callback}{An optional pointer to \helpref{wxProcess}{wxprocess}}
@@ -635,7 +633,7 @@ enum wxSignal
\end{verbatim}
{\tt wxSIGNONE}, {\tt wxSIGKILL} and {\tt wxSIGTERM} have the same meaning
under both Unix and Windows but all the other signals are equivalent to
under both Unix and Windows but all the other signals are equivalent to
{\tt wxSIGTERM} under Windows.
Returns 0 on success, -1 on failure. If {\it rc} parameter is not NULL, it will
@@ -797,7 +795,7 @@ other threads start calling it, if this is not the case this approach can
\func{}{wxENTER\_CRIT\_SECT}{\param{wxCriticalSection\& }{cs}}
This macro is equivalent to \helpref{cs.Enter()}{wxcriticalsectionenter} if
This macro is equivalent to \helpref{cs.Enter()}{wxcriticalsectionenter} if
{\tt wxUSE\_THREADS} is $1$ and does nothing if it is $0$.
@@ -815,7 +813,7 @@ Returns {\tt true} if this thread is the main one. Always returns {\tt true} if
\func{}{wxLEAVE\_CRIT\_SECT}{\param{wxCriticalSection\& }{cs}}
This macro is equivalent to \helpref{cs.Leave()}{wxcriticalsectionleave} if
This macro is equivalent to \helpref{cs.Leave()}{wxcriticalsectionleave} if
{\tt wxUSE\_THREADS} is $1$ and does nothing if it is $0$.
@@ -1561,18 +1559,22 @@ static array of strings containing the weekday names and which have to be
translated (note that it is a bad example, really, as
\helpref{wxDateTime}{wxdatetime} already can be used to get the localized week
day names already). If you write
\begin{verbatim}
static const wxChar * const weekdays[] = { _("Mon"), ..., _("Sun") };
...
// use weekdays[n] as usual
\end{verbatim}
the code wouldn't compile because the function calls are forbidden in the array
initializer. So instead you should do
\begin{verbatim}
static const wxChar * const weekdays[] = { wxTRANSLATE("Mon"), ..., wxTRANSLATE("Sun") };
...
// use wxGetTranslation(weekdays[n])
\end{verbatim}
here.
Note that although the code {\bf would} compile if you simply omit
@@ -2670,7 +2672,7 @@ Initializes the DDE system. May be called multiple times without harm.
This no longer needs to be called by the application: it will be called
by wxWindows if necessary.
See also \helpref{wxDDEServer}{wxddeserver}, \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEConnection}{wxddeconnection},
See also \helpref{wxDDEServer}{wxddeserver}, \helpref{wxDDEClient}{wxddeclient}, \helpref{wxDDEConnection}{wxddeconnection},\rtfsp
\helpref{wxDDECleanUp}{wxddecleanup}.
\wxheading{Include files}

View File

@@ -116,6 +116,7 @@ on a .zip or .htb file!
This protected virtual method may be overridden so that the controller
uses slightly different frame. See {\it samples/html/helpview} sample for
an example.
\membersection{wxHtmlHelpController::Display}\label{wxhtmlhelpcontrollerdisplay}
\func{void}{Display}{\param{const wxString\& }{x}}

View File

@@ -145,7 +145,8 @@ of {\it OpenURL} in derived class.
\wxheading{Parameters}
\docparam{type}{Indicates type of the resource. Is one of
\docparam{type}{Indicates type of the resource. Is one of:
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxHTML\_URL\_PAGE}}{Opening a HTML page.}
\twocolitem{{\bf wxHTML\_URL\_IMAGE}}{Opening an image.}
@@ -187,8 +188,6 @@ The method does these things:
You shouldn't use InitParser, DoParsing, GetProduct or DoneParser directly.
\membersection{wxHtmlParser::PushTagHandler}\label{wxhtmlparserpushtaghandler}
\func{void}{PushTagHandler}{\param{wxHtmlTagHandler* }{handler}, \param{wxString }{tags}}

View File

@@ -33,8 +33,7 @@ None.
\wxheading{See also}
\wxheading{wxIcon}{wxicon}, \helpref{wxFileType::GetIcon()}{wxfiletypegeticon}
\helpref{wxIcon}{wxicon}, \helpref{wxFileType::GetIcon}{wxfiletypegeticon}
\latexignore{\rtfignore{\wxheading{Members}}}

View File

@@ -21,7 +21,7 @@ function that takes a wxInitDialogEvent argument.
\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_INIT\_DIALOG(func)}}{Process a wxEVT\_INIT\_DIALOG event.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -9,6 +9,7 @@ of the strings used to the current language.
\perlnote{In wxPerl you can't use the '\_' function name, so
the {\tt Wx::Locale} module can export the {\tt gettext} and
{\tt gettext\_noop} under any given name.
\begin{verbatim}
# this imports gettext ( equivalent to Wx::GetTranslation
# and gettext_noop ( a noop )
@@ -22,9 +23,11 @@ the {\tt Wx::Locale} module can export the {\tt gettext} and
button = Wx::Button->new( window, -1, gettext( ``Label'' ) );
\end{verbatim}
If you need to translate a lot of strings, then adding gettext( ) around
each one is a long task ( that is why \_( ) was introduced ), so just choose
a shorter name for gettext:
\begin{verbatim}
#
use Wx::Locale 'gettext' => 't',
@@ -37,7 +40,7 @@ a shorter name for gettext:
# ...
\end{verbatim}
}
}%
\wxheading{Derived from}

View File

@@ -172,6 +172,7 @@ Add the {\it mask} to the list of allowed masks for
\helpref{wxLogTrace}{wxlogtrace}.
\wxheading{See also}
\helpref{RemoveTraceMask}{wxlogremovetracemask}
\helpref{GetTraceMasks}{wxloggettracemasks}
@@ -183,6 +184,7 @@ Removes all trace masks previously set with
\helpref{AddTraceMask}{wxlogaddtracemask}.
\wxheading{See also}
\helpref{RemoveTraceMask}{wxlogremovetracemask}
\membersection{wxLog::GetTraceMasks}\label{wxloggettracemasks}
@@ -192,6 +194,7 @@ Removes all trace masks previously set with
Returns the currently allowed list of string trace masks.
\wxheading{See also}
\helpref{AddTraceMask}{wxlogaddtracemask}.
\membersection{wxLog::OnLog}\label{wxlogonlog}
@@ -228,7 +231,7 @@ logging immediately without waiting for \helpref{Flush}{wxlogflush} to be
called (the standard GUI log target only shows the log dialog when it is
flushed, so Suspend() works as expected with it).
\wxheading{See also:}
\wxheading{See also}
\helpref{Resume}{wxlogresume},\\
\helpref{wxLogNull}{wxlogoverview}
@@ -287,7 +290,7 @@ is already empty, nothing happens.
Flushes the current log target if any, does nothing if there is none.
See also:
\wxheading{See also}
\helpref{Flush}{wxlogflush}
@@ -500,7 +503,7 @@ For instance, the example of the overview:
wxLogMessage("..."); // ok
\end{verbatim}
}
}%
would be better written as:
@@ -520,7 +523,7 @@ would be better written as:
...
}
\end{verbatim}
}
}%
\wxheading{Derived from}

View File

@@ -632,7 +632,7 @@ You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free
Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
\end{verbatim}
}
}%
Also add information on how to contact you by electronic and paper mail.
@@ -648,7 +648,7 @@ library `Frob' (a library for tweaking knobs) written by James Random Hacker.
<signature of Ty Coon>, 1 April 1990
Ty Coon, President of Vice
\end{verbatim}
}
}%
That's all there is to it!

View File

@@ -25,7 +25,7 @@ function that takes a wxMouseCaptureChangedEvent argument.
\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_MOUSE\_CAPTURE\_CHANGED(func)}}{Process a wxEVT\_MOUSE\_CAPTURE\_CHANGED event.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -154,6 +154,7 @@ doesn't matter) separated by either {\tt '-'} or {\tt '+'} characters and
followed by the accelerator itself. The accelerator may be any alphanumeric
character, any function key (from {\tt F1} to {\tt F12}) or one of the special
characters listed in the table below (again, case doesn't matter):
\begin{twocollist}\itemsep=0pt
\twocolitem{{\tt DEL} or {\tt DELETE}}{Delete key}
\twocolitem{{\tt INS} or {\tt INSERT}}{Insert key}
@@ -181,7 +182,8 @@ characters listed in the table below (again, case doesn't matter):
\helpref{wxMenu::SetHelpString}{wxmenusethelpstring}, \helpref{wxMenuItem}{wxmenuitem}
\pythonnote{In place of a single overloaded method name, wxPython
implements the following methods:\par
implements the following methods:
\indented{2cm}{\begin{twocollist}
\twocolitem{{\bf Append(id, string, helpStr="", checkable=false)}}{}
\twocolitem{{\bf AppendMenu(id, string, aMenu, helpStr="")}}{}

View File

@@ -31,7 +31,7 @@ specified id has been highlighted: used to show help prompts in the status bar
by \helpref{wxFrame}{wxframe}}
\twocolitem{{\bf EVT\_MENU\_HIGHLIGHT\_ALL(func)}}{A menu item has been
highlighted, i.e. the currently selected menu item has changed.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -20,7 +20,7 @@ function that takes a wxMoveEvent argument.
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_MOVE(func)}}{Process a wxEVT\_MOVE event, which is generated
when a window is moved.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -9,5 +9,5 @@ functions that take a \helpref{wxNotebookEvent}{wxnotebookevent} argument.
wxEVT\_COMMAND\_NOTEBOOK\_PAGE\_CHANGED event.}
\twocolitem{{\bf EVT\_NOTEBOOK\_PAGE\_CHANGING(id, func)}}{The page selection is about to be changed.
Processes a wxEVT\_COMMAND\_NOTEBOOK\_PAGE\_CHANGING event. This event can be \helpref{vetoed}{wxnotifyeventveto}.}
\end{twocollist}%
\end{twocollist}

View File

@@ -10,7 +10,6 @@ pattern that matches certain strings and doesn't match others.
\helpref{wxRegEx}{wxregex}
\subsection{Different Flavors of REs}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -22,11 +21,10 @@ of the traditional {\it egrep}, while BREs are roughly those of the traditional
EREs with some significant extensions.
This manual page primarily describes
AREs. BREs mostly exist for backward compatibility in some old programs;
they will be discussed at the \helpref{end}{wxresynbre}. POSIX EREs are almost an exact subset
of AREs. Features of AREs that are not present in EREs will be indicated.
AREs. BREs mostly exist for backward compatibility in some old programs;
they will be discussed at the \helpref{end}{wxresynbre}. POSIX EREs are almost an exact subset
of AREs. Features of AREs that are not present in EREs will be indicated.
\subsection{Regular Expression Syntax}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -36,16 +34,14 @@ the package written by Henry Spencer, based on the 1003.2 spec and some
(not quite all) of the Perl5 extensions (thanks, Henry!). Much of the description
of regular expressions below is copied verbatim from his manual entry.
An
ARE is one or more {\it branches}, separated by `{\bf $|$}', matching anything that matches
An ARE is one or more {\it branches}, separated by `{\bf $|$}', matching anything that matches
any of the branches.
A branch is zero or more {\it constraints} or {\it quantified
atoms}, concatenated. It matches a match for the first, followed by a match
for the second, etc; an empty branch matches the empty string.
A quantified
atom is an {\it atom} possibly followed by a single {\it quantifier}. Without a quantifier,
A quantified atom is an {\it atom} possibly followed by a single {\it quantifier}. Without a quantifier,
it matches a match for the atom. The quantifiers, and what a so-quantified
atom matches, are:
@@ -89,8 +85,7 @@ a digit, it is the beginning of a {\it bound} (see above)}
character with no other significance, matches that character.}
\end{twocollist}
A {\it constraint}
matches an empty string when specific conditions are met. A constraint may
A {\it constraint} matches an empty string when specific conditions are met. A constraint may
not be followed by a quantifier. The simple constraints are as follows;
some more constraints are described later, under \helpref{Escapes}{wxresynescapes}.
@@ -108,7 +103,6 @@ The lookahead constraints may not contain back references
An RE may not end with `{\bf $\backslash$}'.
\subsection{Bracket Expressions}\label{wxresynbracket}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -219,7 +213,6 @@ by word characters. A word character is an {\it alnum} character or an underscor
({\bf \_}). These special bracket expressions are deprecated; users of AREs should
use constraint escapes instead (see \helpref{Escapes}{wxresynescapes} below).
\subsection{Escapes}\label{wxresynescapes}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -346,7 +339,6 @@ is taken as a back reference if it comes after a suitable subexpression
(i.e. the number is in the legal range for a back reference), and otherwise
is taken as octal.
\subsection{Metasyntax}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -419,7 +411,6 @@ metasyntax extensions is available if the application (or an initial {\bf ***=}
director) has specified that the user's input be treated as a literal string
rather than as an RE.
\subsection{Matching}\label{wxresynmatching}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -440,8 +431,7 @@ atom with other non-greedy quantifiers (including {\bf \{m,n\}?} with {\it m} eq
quantified atom in it which has a preference. An RE consisting of two or
more branches connected by the {\bf $|$} operator prefers longest match.
Subject
to the constraints imposed by the rules for matching the whole RE, subexpressions
Subject to the constraints imposed by the rules for matching the whole RE, subexpressions
also match the longest or shortest possible substrings, based on their
preferences, with subexpressions starting earlier in the RE taking priority
over ones starting later. Note that outer subexpressions thus take priority
@@ -484,7 +474,6 @@ If inverse partial newline-sensitive matching is specified,
this affects {\bf $^$} and {\bf \$} as with newline-sensitive matching, but not {\bf .} and bracket
expressions. This isn't very useful but is provided for symmetry.
\subsection{Limits And Compatibility}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -519,27 +508,23 @@ Henry Spencer's original 1986 {\it regexp} package, still in widespread use,
implemented an early version of today's EREs. There are four incompatibilities between {\it regexp}'s
near-EREs (`RREs' for short) and AREs. In roughly increasing order of significance:
{\itemize
\item
In AREs, {\bf $\backslash$} followed by an alphanumeric character is either an escape or
\item In AREs, {\bf $\backslash$} followed by an alphanumeric character is either an escape or
an error, while in RREs, it was just another way of writing the alphanumeric.
This should not be a problem because there was no reason to write such
a sequence in RREs.
\item%
{\bf \{} followed by a digit in an ARE is the beginning of
\item {\bf \{} followed by a digit in an ARE is the beginning of
a bound, while in RREs, {\bf \{} was always an ordinary character. Such sequences
should be rare, and will often result in an error because following characters
will not look like a valid bound.
\item%
In AREs, {\bf $\backslash$} remains a special character
\item In AREs, {\bf $\backslash$} remains a special character
within `{\bf $[]$}', so a literal {\bf $\backslash$} within {\bf $[]$} must be
written `{\bf $\backslash\backslash$}'. {\bf $\backslash\backslash$} also gives a literal
{\bf $\backslash$} within {\bf $[]$} in RREs, but only truly paranoid programmers routinely doubled
the backslash.
\item%
AREs report the longest/shortest match for the RE, rather
\item AREs report the longest/shortest match for the RE, rather
than the first found in a specified search order. This may affect some RREs
which were written in the expectation that the first match would be reported.
(The careful crafting of RREs to optimize the search order for fast matching
@@ -549,7 +534,6 @@ order was exploited to deliberately find a match which was {\it not} the longes
will need rewriting.)
}
\subsection{Basic Regular Expressions}\label{wxresynbre}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -570,7 +554,6 @@ are available, and {\bf $\backslash<$} and {\bf $\backslash>$} are synonyms
for {\bf $[[:<:]]$} and {\bf $[[:>:]]$} respectively;
no other escapes are available.
\subsection{Regular Expression Character Names}\label{wxresynchars}
\helpref{Syntax of the builtin regular expression library}{wxresyn}
@@ -674,3 +657,4 @@ Note that the character names are case sensitive.
\twocolitem{tilde}{'$~$'}
\twocolitem{DEL}{'$\backslash$177'}
\end{twocollist}

View File

@@ -37,24 +37,25 @@ renderer but it may be changed or extended by the user, see
All drawing functions take some standard parameters:
\begin{itemize}
\item \arg{win} is the window being drawn. It is normally not used and when
it is it should only be used as a generic \helpref{wxWindow}{wxwindow}
(in order to get its low level handle, for example), but you should
\emph{not} assume that it is of some given type as the same renderer
function may be reused for drawing different kinds of control.
\item \arg{dc} is the \helpref{wxDC}{wxdc} to draw on. Only this device
context should be used for drawing. It is not necessary to restore
pens and brushes for it on function exit but, on the other hand, you
shouldn't assume that it is in any specific state on function entry:
the rendering functions should always prepare it.
\item \arg{rect} the bounding rectangle for the element to be drawn.
\item \arg{flags} the optional flags (none by default) which can be a
combination of the \texttt{wxCONTROL\_XXX} constants below.
\item \arg{win} is the window being drawn. It is normally not used and when
it is it should only be used as a generic \helpref{wxWindow}{wxwindow}
(in order to get its low level handle, for example), but you should
\emph{not} assume that it is of some given type as the same renderer
function may be reused for drawing different kinds of control.
\item \arg{dc} is the \helpref{wxDC}{wxdc} to draw on. Only this device
context should be used for drawing. It is not necessary to restore
pens and brushes for it on function exit but, on the other hand, you
shouldn't assume that it is in any specific state on function entry:
the rendering functions should always prepare it.
\item \arg{rect} the bounding rectangle for the element to be drawn.
\item \arg{flags} the optional flags (none by default) which can be a
combination of the \texttt{wxCONTROL\_XXX} constants below.
\end{itemize}
\wxheading{Constants}
The following rendering flags are defined:
\begin{verbatim}
enum
{
@@ -71,7 +72,6 @@ enum
};
\end{verbatim}
\wxheading{Derived from}
No base class

View File

@@ -49,12 +49,14 @@ pointer array.
To declare the smart pointer class \texttt{CLASSNAME} containing pointes to a
(possibly incomplete) type \texttt{TYPE} you should use
\begin{verbatim}
wxDECLARE_SCOPED_PTR( TYPE, // type of the values
CLASSNAME ); // name of the class
\end{verbatim}
And later, when \texttt{TYPE} is fully defined, you must also use
\begin{verbatim}
wxDEFINE_SCOPED_PTR( TYPE, CLASSNAME );
\end{verbatim}
@@ -69,9 +71,11 @@ Alternatively, if you don't have to separate the point of declaration and
definition of this class and if you accept the standard naming convention, that
is that the scoped pointer for the class \texttt{Foo} is called
\texttt{FooPtr}, you can use a single macro which replaces two macros above:
\begin{verbatim}
wxDEFINE_SCOPED_PTR_TYPE( TYPE );
\end{verbatim}
Once again, in this cass \texttt{CLASSNAME} will be \texttt{TYPEPtr}.
\wxheading{Include files}

View File

@@ -89,6 +89,7 @@ and loops until another sound is played,
\end{twocollist}
The static form is shorthand for this code:
\begin{verbatim}
wxSound(filename).Play(flags);
\end{verbatim}

View File

@@ -2,13 +2,14 @@
wxWindows defines a special identifier value {\tt wxID\_ANY} which is used in
the following two situations:
\begin{itemize}
\item when creating a new window you may specify {\tt wxID\_ANY} to let
wxWindows assign an unused identifier to it automatically
\item when installing an event handler using either the event table
macros or \helpref{wxEvtHandler::Connect}{wxevthandlerconnect}
you may use it to indicate that you want to handle the events
coming from any control, regardless of its identifier
\item when creating a new window you may specify {\tt wxID\_ANY} to let
wxWindows assign an unused identifier to it automatically
\item when installing an event handler using either the event table
macros or \helpref{wxEvtHandler::Connect}{wxevthandlerconnect},
you may use it to indicate that you want to handle the events
coming from any control, regardless of its identifier
\end{itemize}
wxWindows also defines a few standard command identifiers which may be used by

View File

@@ -54,7 +54,7 @@ is one of the values of {\tt wxDragResult} enum (explained \helpref{here}{wxdrop
case wxDragMove: /* move the data */ break;
default: /* do nothing */ break;
}
\end{verbatim}
\end{verbatim}%
\end{itemize}
To be a {\it drop target}, i.e. to receive the data dropped by the user you should

View File

@@ -2,11 +2,11 @@
;;; tex2rtf_css.ini for a version using a style sheet. You can use
;;; -macros tex2rtf.ini to specify the ini file.
runTwice = yes
titleFontSize = 12
authorFontSize = 10
authorFontSize = 10
chapterFontSize = 12
sectionFontSize = 12
titleFontSize = 18
authorFontSize = 12
authorFontSize = 12
chapterFontSize = 18
sectionFontSize = 16
subsectionFontSize = 12
contentsDepth = 2
headerRule = yes

View File

@@ -106,14 +106,14 @@ the previous value is used. Returns {\tt false} if the timer could not be starte
If {\it oneShot}\/ is {\tt false} (the default), the \helpref{Notify}{wxtimernotify}
function will be called repeatedly until the timer is stopped. If {\tt true},
it will be called only once and the timer will stop automatically. To make your
code more readable you may also use the following symbolic constants
\twocolwidtha{5cm}%
code more readable you may also use the following symbolic constants:
\twocolwidtha{5cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{wxTIMER\_CONTINUOUS}{Start a normal, continuously running, timer}
\twocolitem{wxTIMER\_ONE\_SHOT}{Start a one shot timer}
\end{twocollist}
If the timer was already running, it will be stopped by this method before
restarting it.

View File

@@ -91,7 +91,6 @@ You can also redirect the {\it wxLogXXX} calls to {\it cout} by just writing:
Finally, there is also a possibility to redirect the output sent to {\it cout}
to a \helpref{wxTextCtrl}{wxtextctrl} by using the
\helpref{wxStreamToTextRedirector}{wxstreamtotextredirector} class.
\item{\bf Flexibility} The output of wxLog functions can be redirected or
suppressed entirely based on their importance, which is either impossible or
difficult to do with traditional methods. For example, only error messages, or
@@ -152,7 +151,7 @@ suppress output of {\it wxLogXXX()} functions. As an example, trying to open a
non-existing file will usually provoke an error message, but if for some
reasons it is unwanted, just use this construction:
{\small
{\small%
\begin{verbatim}
wxFile file;
@@ -165,7 +164,7 @@ reasons it is unwanted, just use this construction:
wxLogMessage("..."); // ok
\end{verbatim}
}
}%
\end{itemize}
The log targets can also be combined: for example you may wish to redirect the

View File

@@ -59,3 +59,4 @@ This chapter contains a selection of topic overviews, first things first:
\input tenvvars.tex
\input wxPython.tex
\input re_syntax.tex

View File

@@ -105,7 +105,7 @@ library are known to have bugs with handling the tree control colours: the
usual symptom is that the expanded items leave black (or otherwise incorrectly
coloured) background behind them, especially for the controls using non
default background colour. The recommended solution is to upgrade the {\tt comctl32.dll}
to a newer version: see
to a newer version: see
\urlref{http://www.microsoft.com/msdownload/ieplatform/ie/comctrlx86.asp}{http://www.microsoft.com/msdownload/ieplatform/ie/comctrlx86.asp}.
\latexignore{\rtfignore{\wxheading{Members}}}
@@ -444,17 +444,16 @@ Returns the tree item data associated with the item.
\twocolitem{{\bf GetPyData(item)}}{Returns the Python Object
associated with the wxTreeItemData for the given item Id.}
\end{twocollist}}
}
}%
\perlnote{wxPerl provides the following shortcut method:
\indented{2cm}{
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf GetPlData( item )}}{Returns the Perl data
associated with the Wx::TreeItemData ( it is just the same as
tree->GetItemData( item )->GetData(); ).}
associated with the Wx::TreeItemData. It is just the same as
tree->GetItemData(item)->GetData().}
\end{twocollist}}
}
}%
\membersection{wxTreeCtrl::GetItemFont}\label{wxtreectrlgetitemfont}
@@ -835,17 +834,16 @@ Sets the item client data.
\twocolitem{{\bf SetPyData(item, obj)}}{Associate the given Python
Object with the wxTreeItemData for the given item Id.}
\end{twocollist}}
}
}%
\perlnote{wxPerl provides the following shortcut method:
\indented{2cm}{
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf SetPlData( item, data )}}{Sets the Perl data
associated with the Wx::TreeItemData ( it is just the same as
tree->GetItemData( item )->SetData( data ); ).}
associated with the Wx::TreeItemData. It is just the same as
tree->GetItemData(item)->SetData(data).}
\end{twocollist}}
}
}%
\membersection{wxTreeCtrl::SetItemFont}\label{wxtreectrlsetitemfont}
@@ -910,6 +908,8 @@ Image list assigned with this method will
See also \helpref{AssignStateImageList}{wxtreectrlassignstateimagelist}.
\membersection{wxTreeCtrl::SetWindowStyle}\label{wxtreectrlsetwindowstyle}
\func{void}{SetWindowStyle}{\param{long}{styles}}
Sets the mode flags associated with the display of the tree control.

View File

@@ -42,7 +42,7 @@ functions that take a wxTreeEvent argument.
\twocolitem{{\bf EVT\_TREE\_KEY\_DOWN(id, func)}}{A key has been pressed.}
\twocolitem{{\bf EVT\_TREE\_ITEM\_GETTOOLTIP(id, func)}}{The opportunity to set the item tooltip
is being given to the application (call wxTreeEvent::SetToolTip). Windows only.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -137,6 +137,7 @@ XRS file is esentially a renamed ZIP archive which means that you can manipulate
it with standard ZIP tools. Note that if you are using XRS files, you have
to initialize \helpref{wxFileSystem}{wxfilesystem} ZIP handler first! It is a simple
thing to do:
\begin{verbatim}
#include <wx/filesys.h>
#include <wx/fs_zip.h>
@@ -155,6 +156,7 @@ Use the {\tt -c} switch to
{\tt wxrc} utility to produce C++ file with embedded resources. This file will
contain a function called {\it InitXmlResource} (unless you override this with
a command line switch). Use it to load the resource:
\begin{verbatim}
extern void InitXMLResource(); // defined in generated file
...
@@ -520,6 +522,7 @@ though you must still use {\tt XRCID} to refer to widget ids in the event
table.
Example:
\begin{verbatim}
#include "resource.h"

View File

@@ -22,7 +22,7 @@ functions that take a wxUpdateUIEvent argument.
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_UPDATE\_UI(id, func)}}{Process a wxEVT\_UPDATE\_UI event for the command with the given id.}
\twocolitem{{\bf EVT\_UPDATE\_UI\_RANGE(id1, id2, func)}}{Process a wxEVT\_UPDATE\_UI event for any command with id included in the given range.}
\end{twocollist}%
\end{twocollist}
\wxheading{Remarks}

View File

@@ -719,7 +719,7 @@ Returns a reference to the list of the window's children.
\constfunc{void}{GetClientSize}{\param{int* }{width}, \param{int* }{height}}
\perlnote{In wxPerl this method takes no parameter and returns
a 2-element list {\tt ( width, height )}.}
a 2-element list {\tt (width, height)}.}
\constfunc{wxSize}{GetClientSize}{\void}
@@ -743,7 +743,7 @@ implements the following methods:\par
\wxheading{See also}
\helpref{GetSize}{wxwindowgetsize}
\helpref{GetSize}{wxwindowgetsize},\rtfsp
\helpref{GetVirtualSize}{wxwindowgetvirtualsize}

View File

@@ -56,7 +56,7 @@ changed (this event can be vetoed).}
the wizard (this event may also be vetoed).}
\twocolitem{{\bf EVT\_WIZARD\_HELP(id, func)}}{The wizard help button was pressed.}
\twocolitem{{\bf EVT\_WIZARD\_FINISHED(id, func)}}{The wizard finished button was pressed.}
\end{twocollist}%
\end{twocollist}
\wxheading{Extended styles}

View File

@@ -41,7 +41,7 @@ changed (this event can be vetoed).}
the wizard (this event may also be vetoed).}
\twocolitem{{\bf EVT\_WIZARD\_HELP(id, func)}}{The wizard help button was pressed.}
\twocolitem{{\bf EVT\_WIZARD\_FINISHED(id, func)}}{The wizard finished button was pressed.}
\end{twocollist}%
\end{twocollist}
\wxheading{See also}

View File

@@ -164,6 +164,7 @@ Sets the next page.
A convenience function to make the pages follow each other.
Example:
\begin{verbatim}
wxRadioboxPage *page3 = new wxRadioboxPage(wizard);
wxValidationPage *page4 = new wxValidationPage(wizard);