document wxFORCE_LINK_THIS_MODULE, wxFORCE_LINK_MODULE, wxIMPLEMENT_APP macros

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@49933 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Francesco Montorsi
2007-11-13 20:48:00 +00:00
parent 9eac91c432
commit 6d98f9631a

View File

@@ -9,7 +9,7 @@
%% License: wxWindows license %% License: wxWindows license
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\chapter{Functions}\label{functions} \chapter{Functions and macros}\label{functions}
\setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}% \setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
\setfooter{\thepage}{}{}{}{}{\thepage} \setfooter{\thepage}{}{}{}{}{\thepage}
@@ -2848,7 +2848,7 @@ Passes data to the clipboard.
The clipboard must have previously been opened for this call to succeed. The clipboard must have previously been opened for this call to succeed.
\section{Miscellaneous functions}\label{miscellany} \section{Miscellaneous functions and macros}\label{miscellany}
\membersection{wxBase64Decode}\label{wxbase64decode} \membersection{wxBase64Decode}\label{wxbase64decode}
@@ -3741,6 +3741,59 @@ Use these macros to read data from and write data to a file that stores
data in big-endian format. data in big-endian format.
\membersection{wxFORCE\_LINK\_THIS\_MODULE}\label{wxforcelinkthismodule}
\func{}{wxFORCE\_LINK\_THIS\_MODULE}{moduleName}
This macro can be used in conjunction with the
\helpref{wxFORCE\_LINK\_MODULE}{wxforcelinkmodule} macro to force
the linker to include in its output a specific object file.
In particular, you should use this macro in the source file which you want
to force for inclusion. The \tt{moduleName} needs to be a name not already
in use in other \tt{wxFORCE\_LINK\_THIS\_MODULE} macros, but is not required
to be e.g. the same name of the source file (even if it's a good choice).
\wxheading{Include files}
<wx/link.h>
\membersection{wxFORCE\_LINK\_MODULE}\label{wxforcelinkmodule}
\func{}{wxFORCE\_LINK\_MODULE}{moduleName}
This macro can be used in conjunction with the
\helpref{wxFORCE\_LINK\_THIS\_MODULE}{wxforcelinkthismodule} macro to force
the linker to include in its output a specific object file.
In particular, you should use this macro in a source file which you know
for sure is linked in the output (e.g. the source file containing the "main()"
of your app). The \tt{moduleName} is the name of the module you want to forcefully link
(i.e. the name you used in the relative \helpref{wxFORCE\_LINK\_THIS\_MODULE}{wxforcelinkthismodule} macro.
\wxheading{Include files}
<wx/link.h>
\membersection{wxIMPLEMENT\_APP}\label{wximplementapp}
\func{}{wxIMPLEMENT\_APP}{className}
This is used in the application class implementation file to make the application class
known to wxWidgets for dynamic construction. You use this as:
\begin{verbatim}
wxIMPLEMENT_APP(MyApp)
\end{verbatim}
See also \helpref{wxDECLARE\_APP}{wxdeclareapp}.
\wxheading{Include files}
<wx/app.h>
\section{RTTI functions}\label{rttimacros} \section{RTTI functions}\label{rttimacros}