X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/db882c54314562f533d25f9b25b65966649e231b..71aba8333cc915afff9e740c944f7fa7247abacb:/docs/latex/wx/function.tex?ds=inline diff --git a/docs/latex/wx/function.tex b/docs/latex/wx/function.tex index 335c34f955..0318e25402 100644 --- a/docs/latex/wx/function.tex +++ b/docs/latex/wx/function.tex @@ -65,6 +65,7 @@ the corresponding topic. \helpref{wxDos2UnixFilename}{wxdos2unixfilename}\\ \helpref{wxDynamicCastThis}{wxdynamiccastthis}\\ \helpref{wxDynamicCast}{wxdynamiccast}\\ +\helpref{wxDYNLIB\_FUNCTION}{wxdynlibfunction}\\ \helpref{wxEmptyClipboard}{wxemptyclipboard}\\ \helpref{wxEnableTopLevelWindows}{wxenabletoplevelwindows}\\ \helpref{wxEndBusyCursor}{wxendbusycursor}\\ @@ -470,17 +471,23 @@ processes. \func{long}{wxExecute}{\param{const wxString\& }{command}, \param{int }{sync = wxEXEC\_ASYNC}, \param{wxProcess *}{callback = NULL}} +\perlnote{In wxPerl this function is called \texttt{Wx::ExecuteCommand}} + \func{long}{wxExecute}{\param{char **}{argv}, \param{int }{flags = wxEXEC\_ASYNC}, \param{wxProcess *}{callback = NULL}} +\perlnote{In wxPerl this function is called \texttt{Wx::ExecuteArgs}} + \func{long}{wxExecute}{\param{const wxString\& }{command}, \param{wxArrayString\& }{output}} -\perlnote{In wxPerl this function only takes the {\tt command} argument, +\perlnote{In wxPerl this function is called \texttt{Wx::ExecuteStdout} and it +only takes the {\tt command} argument, and returns a 2-element list {\tt ( status, output )}, where {\tt output} is an array reference.} \func{long}{wxExecute}{\param{const wxString\& }{command}, \param{wxArrayString\& }{output}, \param{wxArrayString\& }{errors}} -\perlnote{In wxPerl this function only takes the {\tt command} argument, +\perlnote{In wxPerl this function is called \texttt{Wx::ExecuteStdoutStderr} +and it only takes the {\tt command} argument, and returns a 3-element list {\tt ( status, output, errors )}, where {\tt output} and {\tt errors} are array references.} @@ -1511,8 +1518,6 @@ same macro which is {\tt \_TEXT()}). Don't confuse this macro with \helpref{\_()}{underscore}! -\membersection{\_}\label{underscore} - \section{Dialog functions}\label{dialogfunctions} Below are a number of convenience functions for getting input from the @@ -1949,7 +1954,7 @@ For example: int answer = wxMessageBox("Quit program?", "Confirm", wxYES_NO | wxCANCEL, main_frame); if (answer == wxYES) - delete main_frame; + main_frame->Close(); ... \end{verbatim} @@ -2354,8 +2359,34 @@ Passes data to the clipboard. The clipboard must have previously been opened for this call to succeed. + \section{Miscellaneous functions}\label{miscellany} +\membersection{wxDYNLIB\_FUNCTION}\label{wxdynlibfunction} + +\func{}{wxDYNLIB\_FUNCTION}{\param{}{type}, \param{}{name}, \param{}{dynlib}} + +When loading a function from a DLL you always have to cast the returned +\tt{void *} pointer to the correct type and, even more annoyingly, you have to +repeat this type twice if you want to declare and define a function pointer all +in one line + +This macro makes this slightly less painful by allowing you to specify the +type only once, as the first parameter, and creating a variable of this type +named after the function but with {\tt pfn} prefix and initialized with the +function \arg{name} from the \helpref{wxDynamicLibrary}{wxdynamiclibrary} +\arg{dynlib}. + +\wxheading{Parameters} + +\docparam{type}{the type of the function} + +\docparam{name}{the name of the function to load, not a string (without quotes, +it is quoted automatically by the macro)} + +\docparam{dynlib}{the library to load the function from} + + \membersection{wxEXPLICIT}\label{wxexplicit} {\tt wxEXPLICIT} is a macro which expands to the C++ {\tt explicit} keyword if