X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/aaa6f9ba6bd0be1fe6a34800e6f753ffdc49900c..e9793aef3c7b27ccd65a7b3353464d7a3681c52c:/docs/latex/wx/filepicker.tex diff --git a/docs/latex/wx/filepicker.tex b/docs/latex/wx/filepicker.tex index f21c9e5687..93293aac5e 100644 --- a/docs/latex/wx/filepicker.tex +++ b/docs/latex/wx/filepicker.tex @@ -32,7 +32,9 @@ It is only available if \texttt{wxUSE\_FILEPICKERCTRL} is set to $1$ (the defaul \twocolwidtha{5cm}% \begin{twocollist}\itemsep=0pt -\twocolitem{\windowstyle{wxFLP\_DEFAULT\_STYLE}}{Default style.} +\twocolitem{\windowstyle{wxFLP\_DEFAULT\_STYLE}}{The default style: includes +wxFLP\_OPEN | wxFLP\_FILE\_MUST\_EXIST and, under wxMSW only, +wxFLP\_USE\_TEXTCTRL.} \twocolitem{\windowstyle{wxFLP\_USE\_TEXTCTRL}}{Creates a text control to the left of the picker button which is completely managed by the \helpref{wxFilePickerCtrl}{wxfilepickerctrl} and which can be used by the user to specify a path (see \helpref{SetPath}{wxfilepickerctrlsetpath}). @@ -49,6 +51,9 @@ NB: the wxFD\_MULTIPLE style of wxFileDialog is not supported! \wxheading{Event handling} +To process a file picker event, use these event handler macros to direct input to member +functions that take a \helpref{wxFileDirPickerEvent}{wxfiledirpickerevent} argument. + \twocolwidtha{7cm}% \begin{twocollist}\itemsep=0pt \twocolitem{{\bf EVT\_FILEPICKER\_CHANGED(id, func)}}{The user changed the file @@ -123,19 +128,35 @@ all the parameters. \true if the control was successfully created or \false if creation failed. +\membersection{wxFilePickerCtrl::GetFileName}\label{wxfilepickerctrlgetfilename} + +\constfunc{wxFileName}{GetFileName}{\void} + +Similar to \helpref{GetPath}{wxfilepickerctrlgetpath} but returns the path of +the currently selected file as a \helpref{wxFileName}{wxfilename} object. + + \membersection{wxFilePickerCtrl::GetPath}\label{wxfilepickerctrlgetpath} \constfunc{wxString}{GetPath}{\void} -Returns the currently selected file. +Returns the absolute path of the currently selected file. + + +\membersection{wxFilePickerCtrl::SetFileName}\label{wxfilepickerctrlsetfilename} + +\func{void}{SetFileName}{\param{const wxFileName \&}{filename}} + +This method does the same thing as \helpref{SetPath}{wxfilepickerctrlsetpath} but +takes a \helpref{wxFileName}{wxfilename} object instead of a string. \membersection{wxFilePickerCtrl::SetPath}\label{wxfilepickerctrlsetpath} \func{void}{SetPath}{\param{const wxString \&}{filename}} -Sets the currently selected file. This must be a valid file if -{\tt wxFLP\_FILE\_MUST\_EXIST} style was given. +Sets the absolute path of the currently selected file. This must be a valid file if +the {\tt wxFLP\_FILE\_MUST\_EXIST} style was given. @@ -185,11 +206,12 @@ The constructor is not normally used by the user code. \constfunc{wxString}{GetPath}{\void} -Retrieve the file/directory the user has just selected. +Retrieve the absolute path of the file/directory the user has just selected. \membersection{wxFileDirPickerEvent::SetPath}\label{wxfiledirpickereventsetpath} \func{void}{SetPath}{\param{const wxString \&}{path}} -Set the file/directory associated with the event. +Set the absolute path of the file/directory associated with the event. +