X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/8ad9ca97bb6fa4e30a685d36966035b6ab399119..d3f00f59938d4801a95afa1cd638b8f15c481ee3:/docs/latex/wx/filedlg.tex diff --git a/docs/latex/wx/filedlg.tex b/docs/latex/wx/filedlg.tex index 29e10053dc..f89856c61f 100644 --- a/docs/latex/wx/filedlg.tex +++ b/docs/latex/wx/filedlg.tex @@ -13,20 +13,44 @@ This class represents the file chooser dialog. +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + +\wxheading{Window styles} + +\begin{twocollist}\itemsep=0pt +\twocolitem{\windowstyle{wxFD\_DEFAULT\_STYLE}}{Equivalent to wxFD\_OPEN.} +\twocolitem{\windowstyle{wxFD\_OPEN}}{This is an open dialog; usually this means that the default button's label of the dialog is "Open". Cannot be combined with wxFD\_SAVE.} +\twocolitem{\windowstyle{wxFD\_SAVE}}{This is a save dialog; usually this means that the default button's label of the dialog is "Save". Cannot be combined with wxFD\_OPEN.} +\twocolitem{{\windowstyle wxFD\_OVERWRITE\_PROMPT}}{For save dialog only: prompt for a confirmation if a file will be overwritten.} +\twocolitem{{\windowstyle wxFD\_FILE\_MUST\_EXIST}}{For open dialog only: the user may only select files that actually exist.} +\twocolitem{{\windowstyle wxFD\_MULTIPLE}}{For open dialog only: allows selecting multiple files.} +\twocolitem{{\windowstyle wxFD\_CHANGE\_DIR}}{Change the current working directory to the directory where the file(s) chosen by the user are.} +\twocolitem{{\windowstyle wxFD\_PREVIEW}}{Show the preview of the selected files (currently only supported by wxGTK using GTK+ 2.4 or later).} +\end{twocollist} + +{\bf NB:} Previous versions of wxWidgets used {\tt wxFD\_CHANGE\_DIR} by default +under MS Windows which allowed the program to simply remember the last +directory where user selected the files to open/save. This (desired) +functionality must be implemented in the program itself now (manually remember +the last path used and pass it to the dialog the next time it is called) or +by using this flag. + + \wxheading{See also} \helpref{wxFileDialog overview}{wxfiledialogoverview}, \helpref{wxFileSelector}{wxfileselector} \wxheading{Remarks} -Pops up a file selector box. In Windows, this is the common file selector -dialog. In X, this is a file selector box with somewhat less functionality. -The path and filename are distinct elements of a full file pathname. +Pops up a file selector box. In Windows and GTK2.4+, this is the common +file selector dialog. In X, this is a file selector box with somewhat less +functionality. The path and filename are distinct elements of a full file pathname. If path is ``", the current directory will be used. If filename is ``", no default filename will be supplied. The wildcard determines what files are displayed in the file selector, and file extension supplies a type -extension for the required filename. Flags may be a combination of wxOPEN, -wxSAVE, wxOVERWRITE\_PROMPT, wxHIDE\_READONLY, wxFILE\_MUST\_EXIST, wxMULTIPLE or 0. +extension for the required filename. Both the X and Windows versions implement a wildcard filter. Typing a filename containing wildcards (*, ?) in the filename text item, and @@ -35,7 +59,7 @@ displayed. The wildcard may be a specification for multiple types of file with a description for each, such as: \begin{verbatim} - "BMP files (*.bmp)|*.bmp|GIF files (*.gif)|*.gif" + "BMP and GIF files (*.bmp;*.gif)|*.bmp;*.gif|PNG files (*.png)|*.png" \end{verbatim} It must be noted that wildcard support in the native Motif file @@ -47,11 +71,11 @@ is displayed as ``*.bmp'', and both \latexignore{\rtfignore{\wxheading{Members}}} -\membersection{wxFileDialog::wxFileDialog}\label{wxfiledialogconstr} +\membersection{wxFileDialog::wxFileDialog}\label{wxfiledialogctor} \func{}{wxFileDialog}{\param{wxWindow* }{parent}, \param{const wxString\& }{message = "Choose a file"},\rtfsp \param{const wxString\& }{defaultDir = ""}, \param{const wxString\& }{defaultFile = ``"},\rtfsp -\param{const wxString\& }{wildcard = ``*.*"}, \param{long }{style = 0}, \param{const wxPoint\& }{pos = wxDefaultPosition}} +\param{const wxString\& }{wildcard = ``*.*"}, \param{long }{style = wxFD\_DEFAULT\_STYLE}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{sz = wxDefaultSize}, \param{const wxString\& }{name = "filedlg"}} Constructor. Use \helpref{wxFileDialog::ShowModal}{wxfiledialogshowmodal} to show the dialog. @@ -70,29 +94,16 @@ Constructor. Use \helpref{wxFileDialog::ShowModal}{wxfiledialogshowmodal} to sho Note that the native Motif dialog has some limitations with respect to wildcards; see the Remarks section above.} -\docparam{style}{A dialog style. A bitlist of: - -\twocolwidtha{5cm} -\begin{twocollist} -\twocolitem{{\bf wxOPEN}}{This is an open dialog.} -\twocolitem{{\bf wxSAVE}}{This is a save dialog.} -\twocolitem{{\bf wxHIDE\_READONLY}}{For open dialog only: hide the checkbox allowing to open the file in read-only mode.} -\twocolitem{{\bf wxOVERWRITE\_PROMPT}}{For save dialog only: prompt for a confirmation if a file will be overwritten.} -\twocolitem{{\bf wxMULTIPLE}}{For open dialog only: allows selecting multiple files.} -\twocolitem{{\bf wxCHANGE\_DIR}}{Change the current working directory to the directory where the file(s) chosen by the user are.} -\end{twocollist}% -} +\docparam{style}{A dialog style. See wxFD\_* styles for more info.} \docparam{pos}{Dialog position. Not implemented.} -{\bf NB:} Previous versions of wxWindows used {\tt wxCHANGE\_DIR} by default -under MS Windows which allowed the program to simply remember the last -directory where user selected the files to open/save. This (desired) -functionality must be implemented in the program itself now (manually remember -the last path used and pass it to the dialog the next time it is called) or -by using this flag. +\docparam{size}{Dialog size. Not implemented.} + +\docparam{name}{Dialog name. Not implemented.} + -\membersection{wxFileDialog::\destruct{wxFileDialog}} +\membersection{wxFileDialog::\destruct{wxFileDialog}}\label{wxfiledialogdtor} \func{}{\destruct{wxFileDialog}}{\void} @@ -115,7 +126,7 @@ Returns the default filename. \constfunc{void}{GetFilenames}{\param{wxArrayString\& }{filenames}} Fills the array {\it filenames} with the names of the files chosen. This -function should only be used with the dialogs which have {\tt wxMULTIPLE} style, +function should only be used with the dialogs which have {\tt wxFD\_MULTIPLE} style, use \helpref{GetFilename}{wxfiledialoggetfilename} for the others. Note that under Windows, if the user selects shortcuts, the filenames @@ -148,15 +159,9 @@ Returns the full path (directory and filename) of the selected file. \constfunc{void}{GetPaths}{\param{wxArrayString\& }{paths}} Fills the array {\it paths} with the full paths of the files chosen. This -function should only be used with the dialogs which have {\tt wxMULTIPLE} style, +function should only be used with the dialogs which have {\tt wxFD\_MULTIPLE} style, use \helpref{GetPath}{wxfiledialoggetpath} for the others. -\membersection{wxFileDialog::GetStyle}\label{wxfiledialoggetstyle} - -\constfunc{long}{GetStyle}{\void} - -Returns the dialog style. - \membersection{wxFileDialog::GetWildcard}\label{wxfiledialoggetwildcard} \constfunc{wxString}{GetWildcard}{\void} @@ -193,12 +198,6 @@ Sets the message that will be displayed on the dialog. Sets the path (the combined directory and filename that will be returned when the dialog is dismissed). -\membersection{wxFileDialog::SetStyle}\label{wxfiledialogsetstyle} - -\func{void}{SetStyle}{\param{long }{style}} - -Sets the dialog style. See \helpref{wxFileDialog::wxFileDialog}{wxfiledialogconstr} for details. - \membersection{wxFileDialog::SetWildcard}\label{wxfiledialogsetwildcard} \func{void}{SetWildcard}{\param{const wxString\& }{wildCard}}