X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/6d94009faa51ae4018e08ced13cfdfe575b03f08..e31f4da5f0e888e3bae947061be02a427c570372:/docs/latex/wx/dynlib.tex diff --git a/docs/latex/wx/dynlib.tex b/docs/latex/wx/dynlib.tex index 505832463b..33d6266ef4 100644 --- a/docs/latex/wx/dynlib.tex +++ b/docs/latex/wx/dynlib.tex @@ -16,12 +16,6 @@ wxDynamicLibrary is a class representing dynamically loadable library this class to load a library and don't worry about unloading it -- it will be done in the objects destructor automatically. -% deprecated now... -% -%\wxheading{See also} -% -%\helpref{wxDllLoader}{wxdllloader} - \wxheading{Derived from} No base class. @@ -45,7 +39,7 @@ Constructor. Second form calls \helpref{Load}{wxdynamiclibraryload}. \membersection{wxDynamicLibrary::CanonicalizeName}\label{wxdynamiclibrarycanonicalizename} -\func{wxString}{CanonicalizeName}{\param{const wxString\& }{name}, \param{wxDynamicLibraryCategory}{ cat = wxDL\_LIBRARY}} +\func{static wxString}{CanonicalizeName}{\param{const wxString\& }{name}, \param{wxDynamicLibraryCategory}{ cat = wxDL\_LIBRARY}} 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 @@ -66,7 +60,7 @@ The possible values for \arg{cat} are: \membersection{wxDynamicLibrary::CanonicalizePluginName}\label{wxdynamiclibrarycanonicalizepluginname} -\func{wxString}{CanonicalizePluginName}{\param{const wxString\& }{name}, \param{wxPluginCategory}{ cat = wxDL\_PLUGIN\_GUI}} +\func{static wxString}{CanonicalizePluginName}{\param{const wxString\& }{name}, \param{wxPluginCategory}{ cat = wxDL\_PLUGIN\_GUI}} This function does the same thing as \helpref{CanonicalizeName}{wxdynamiclibrarycanonicalizename} but for wxWidgets @@ -88,7 +82,7 @@ The possible values for \arg{cat} are: 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 -responsability to do this using \helpref{Unload}{wxdynamiclibraryunload}. +responsibility to do this using \helpref{Unload}{wxdynamiclibraryunload}. \membersection{wxDynamicLibrary::GetSymbol}\label{wxdynamiclibrarygetsymbol} @@ -103,6 +97,19 @@ contains no such symbol. \helpref{wxDYNLIB\_FUNCTION}{wxdynlibfunction} +\membersection{wxDynamicLibrary::GetSymbolAorW}\label{wxdynamiclibrarygetsymbolaorw} + +\constfunc{void *}{GetSymbolAorW}{\param{const wxString\& }{name}} + +This function is available only under Windows as it is only useful when +dynamically loading symbols from standard Windows DLLs. Such functions have +either \texttt{'A'} (in ANSI build) or \texttt{'W'} (in Unicode, or wide +character build) suffix if they take string parameters. Using this function you +can use just the base name of the function and the correct suffix is appende +automatically depending on the current build. Otherwise, this method is +identical to \helpref{GetSymbol}{wxdynamiclibrarygetsymbol}. + + \membersection{wxDynamicLibrary::GetProgramHandle}\label{wxdynamiclibrarygetprogramhandle} \func{static wxDllType}{GetProgramHandle}{\void} @@ -136,7 +143,7 @@ Returns \true if the library was successfully loaded, \false otherwise. This static method returns an \helpref{array}{wxarray} containing the details of all modules loaded into the address space of the current project, the array elements are object of \texttt{wxDynamicLibraryDetails} class. The array will -be empty if an error occured. +be empty if an error occurred. This method is currently implemented only under Win32 and Linux and is useful mostly for diagnostics purposes.