2002-01-14 11:40:44 -05:00
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
%% Name: dynlib.tex
|
|
|
|
%% Purpose: wxDynamicLibrary documentation
|
|
|
|
%% Author: Vadim Zeitlin
|
|
|
|
%% Modified by:
|
|
|
|
%% Created: 14.01.02 (extracted from dllload.tex)
|
|
|
|
%% RCS-ID: $Id$
|
|
|
|
%% Copyright: (c) Vadim Zeitlin
|
|
|
|
%% License: wxWindows license
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
|
|
|
|
|
|
\section{\class{wxDynamicLibrary}}\label{wxdynamiclibrary}
|
|
|
|
|
|
|
|
wxDynamicLibrary is a class representing dynamically loadable library
|
2003-08-04 10:05:00 -04:00
|
|
|
(Windows DLL, shared library under Unix etc.). Just create an object of
|
|
|
|
this class to load a library and don't worry about unloading it -- it will be
|
|
|
|
done in the objects destructor automatically.
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
% deprecated now...
|
|
|
|
%
|
|
|
|
%\wxheading{See also}
|
|
|
|
%
|
|
|
|
%\helpref{wxDllLoader}{wxdllloader}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxDynamicLibrary::wxDynamicLibrary}\label{wxdynamiclibrarywxdynamiclibrary}
|
|
|
|
|
|
|
|
\func{}{wxDynamicLibrary}{\void}
|
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\func{}{wxDynamicLibrary}{\param{const wxString\& }{name}, \param{int }{flags = wxDL\_DEFAULT}}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
|
|
|
Constructor. Second form calls \helpref{Load}{wxdynamiclibraryload}.
|
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\membersection{wxDynamicLibrary::CanonicalizeName}\label{wxdynamiclibrarycanonicalizename}
|
|
|
|
|
2003-08-13 10:38:32 -04:00
|
|
|
\func{wxString}{CanonicalizeName}{\param{const wxString\& }{name}, \param{wxDynamicLibraryCategory}{ cat = wxDL\_LIBRARY}}
|
2003-08-04 10:05:00 -04:00
|
|
|
|
|
|
|
Returns the platform-specific full name for the library called \arg{name}. E.g.
|
|
|
|
it adds a {\tt ".dll"} extension under Windows and {\tt "lib"} prefix and
|
|
|
|
{\tt ".so"}, {\tt ".sl"} or maybe {\tt ".dylib"} extension under Unix.
|
|
|
|
|
|
|
|
The possible values for \arg{cat} are:
|
2003-08-13 10:38:32 -04:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\begin{twocollist}
|
|
|
|
\twocolitem{wxDL\_LIBRARY}{normal library}
|
|
|
|
\twocolitem{wxDL\_MODULE}{a loadable module or plugin}
|
|
|
|
\end{twocollist}
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{CanonicalizePluginName}{wxdynamiclibrarycanonicalizepluginname}
|
|
|
|
|
|
|
|
|
|
|
|
\membersection{wxDynamicLibrary::CanonicalizePluginName}\label{wxdynamiclibrarycanonicalizepluginname}
|
|
|
|
|
2003-08-13 10:38:32 -04:00
|
|
|
\func{wxString}{CanonicalizePluginName}{\param{const wxString\& }{name}, \param{wxPluginCategory}{ cat = wxDL\_PLUGIN\_GUI}}
|
2003-08-04 10:05:00 -04:00
|
|
|
|
|
|
|
This function does the same thing as
|
|
|
|
\helpref{CanonicalizeName}{wxdynamiclibrarycanonicalizename} but for wxWindows
|
|
|
|
plugins. The only difference is that compiler and version information are added
|
|
|
|
to the name to ensure that the plugin which is going to be loaded will be
|
|
|
|
compatible with the main program.
|
|
|
|
|
|
|
|
The possible values for \arg{cat} are:
|
2003-08-13 10:38:32 -04:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\begin{twocollist}
|
|
|
|
\twocolitem{wxDL\_PLUGIN\_GUI}{plugin which uses GUI classes (default)}
|
|
|
|
\twocolitem{wxDL\_PLUGIN\_BASE}{plugin which only uses wxBase}
|
|
|
|
\end{twocollist}
|
|
|
|
|
2003-03-03 20:48:47 -05:00
|
|
|
\membersection{wxDynamicLibrary::Detach}\label{wxdynamiclibrarydetach}
|
|
|
|
|
|
|
|
\func{wxDllType}{Detach}{\void}
|
|
|
|
|
|
|
|
Detaches this object from its library handle, i.e. the object will not unload
|
|
|
|
the library any longer in its destructor but it is now the callers
|
2003-08-04 10:05:00 -04:00
|
|
|
responsability to do this using \helpref{Unload}{wxdynamiclibraryunload}.
|
|
|
|
|
|
|
|
\membersection{wxDynamicLibrary::GetSymbol}\label{wxdynamiclibrarygetsymbol}
|
|
|
|
|
|
|
|
\constfunc{void*}{GetSymbol}{\param{const wxString\& }{name}}
|
|
|
|
|
|
|
|
Returns pointer to symbol {\it name} in the library or NULL if the library
|
|
|
|
contains no such symbol.
|
|
|
|
|
|
|
|
\wxheading{See also}
|
|
|
|
|
|
|
|
\helpref{wxDYNLIB\_FUNCTION}{wxdynlibfunction}
|
|
|
|
|
2002-01-14 11:40:44 -05:00
|
|
|
\membersection{wxDynamicLibrary::IsLoaded}\label{wxdynamiclibraryisloaded}
|
|
|
|
|
|
|
|
\constfunc{bool}{IsLoaded}{\void}
|
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
Returns \true if the library was successfully loaded, \false otherwise.
|
|
|
|
|
2002-01-14 11:40:44 -05:00
|
|
|
\membersection{wxDynamicLibrary::Load}\label{wxdynamiclibraryload}
|
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\func{bool}{Load}{\param{const wxString\& }{name}, \param{int }{flags = wxDL\_DEFAULT}}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
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}
|
|
|
|
\twocolitem{wxDL\_GLOBAL}{equivalent of RTLD\_GLOBAL under Unix, ignored elsewhere}
|
|
|
|
\twocolitem{wxDL\_VERBATIM}{don't try to append the appropriate extension to
|
|
|
|
the library name (this is done by default).}
|
|
|
|
\end{twocollist}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
Returns \true if the library was successfully loaded, \false otherwise.
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\membersection{wxDynamicLibrary::Unload}\label{wxdynamiclibraryunload}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\func{void}{Unload}{\void}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
\func{static void}{Unload}{\param{wxDllType }{handle}}
|
2002-01-14 11:40:44 -05:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
Unloads the library from memory. wxDynamicLibrary object automatically calls
|
|
|
|
this method from its destructor if it had been successfully loaded.
|
2003-08-01 19:36:26 -04:00
|
|
|
|
2003-08-04 10:05:00 -04:00
|
|
|
The second version is only used if you need to keep the library in memory
|
|
|
|
during a longer period of time than the scope of the wxDynamicLibrary object.
|
|
|
|
In this case you may call \helpref{Detach}{wxdynamiclibrarydetach} and store
|
|
|
|
the handle somewhere and call this static method later to unload it.
|
2002-01-14 11:40:44 -05:00
|
|
|
|