--- a/eric7/Documentation/Source/eric7.EricWidgets.EricFileDialog.html Sun May 30 19:03:39 2021 +0200 +++ b/eric7/Documentation/Source/eric7.EricWidgets.EricFileDialog.html Thu Jun 03 15:58:59 2021 +0200 @@ -23,8 +23,7 @@ <h1>eric7.EricWidgets.EricFileDialog</h1> <p> -Module implementing alternative functions for the QFileDialog static methods -to cope with distributor's usage of KDE wrapper dialogs for Qt file dialogs. +Module implementing alternative functions for the QFileDialog static methods. </p> <h3>Global Attributes</h3> @@ -49,6 +48,10 @@ <td>Module function to get the name of a directory.</td> </tr> <tr> +<td><a href="#getOpenFileAndDirNames">getOpenFileAndDirNames</a></td> +<td>Module function to get the names of files and directories for opening.</td> +</tr> +<tr> <td><a href="#getOpenFileName">getOpenFileName</a></td> <td>Module function to get the name of a file for opening it.</td> </tr> @@ -85,19 +88,25 @@ </p> <dl> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -Qt file filter (string) +Qt file filter </dd> -<dt><i>initialFilter</i></dt> +<dt><i>initialFilter</i> (str)</dt> <dd> -initial filter (string) +initial filter </dd> </dl> <dl> <dt>Return:</dt> <dd> -the rearranged Qt file filter (string) +the rearranged Qt file filter +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +str </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -112,27 +121,78 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -name of selected directory (string) +name of selected directory +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +str +</dd> +</dl> +<div align="right"><a href="#top">Up</a></div> +<hr /> +<hr /> +<a NAME="getOpenFileAndDirNames" ID="getOpenFileAndDirNames"></a> +<h2>getOpenFileAndDirNames</h2> +<b>getOpenFileAndDirNames</b>(<i>parent=None, caption="", directory="", filterStr="", options=None</i>) + +<p> + Module function to get the names of files and directories for opening. +</p> +<dl> + +<dt><i>parent</i> (QWidget)</dt> +<dd> +parent widget of the dialog +</dd> +<dt><i>caption</i> (str)</dt> +<dd> +window title of the dialog +</dd> +<dt><i>directory</i> (str)</dt> +<dd> +working directory of the dialog +</dd> +<dt><i>filterStr</i> (str)</dt> +<dd> +filter string for the dialog +</dd> +<dt><i>options</i> (QFileDialog.Options)</dt> +<dd> +various options for the dialog +</dd> +</dl> +<dl> +<dt>Return:</dt> +<dd> +names of the selected files and folders +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +list of str </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -147,31 +207,37 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -name of file to be opened (string) +name of file to be opened +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +str </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -187,35 +253,41 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>initialFilter</i></dt> +<dt><i>initialFilter</i> (str)</dt> <dd> -initial filter for the dialog (string) +initial filter for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -name of file to be opened and selected filter (string, string) +name of file to be opened and selected filter +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +tuple of (str, str) </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -230,31 +302,37 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -list of file names to be opened (list of string) +list of file names to be opened +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +list of str </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -270,36 +348,41 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>initialFilter</i></dt> +<dt><i>initialFilter</i> (str)</dt> <dd> -initial filter for the dialog (string) +initial filter for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> list of file names to be opened and selected filter - (list of string, string) +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +tuple of (list of str, str) </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -314,31 +397,37 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -name of file to be saved (string) +name of file to be saved +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +str </dd> </dl> <div align="right"><a href="#top">Up</a></div> @@ -354,35 +443,41 @@ </p> <dl> -<dt><i>parent</i></dt> +<dt><i>parent</i> (QWidget)</dt> <dd> -parent widget of the dialog (QWidget) +parent widget of the dialog </dd> -<dt><i>caption</i></dt> +<dt><i>caption</i> (str)</dt> <dd> -window title of the dialog (string) +window title of the dialog </dd> -<dt><i>directory</i></dt> +<dt><i>directory</i> (str)</dt> <dd> -working directory of the dialog (string) +working directory of the dialog </dd> -<dt><i>filterStr</i></dt> +<dt><i>filterStr</i> (str)</dt> <dd> -filter string for the dialog (string) +filter string for the dialog </dd> -<dt><i>initialFilter</i></dt> +<dt><i>initialFilter</i> (str)</dt> <dd> -initial filter for the dialog (string) +initial filter for the dialog </dd> -<dt><i>options</i></dt> +<dt><i>options</i> (QFileDialog.Options)</dt> <dd> -various options for the dialog (QFileDialog.Options) +various options for the dialog </dd> </dl> <dl> <dt>Return:</dt> <dd> -name of file to be saved and selected filter (string, string) +name of file to be saved and selected filte +</dd> +</dl> +<dl> +<dt>Return Type:</dt> +<dd> +tuple of (str, str) </dd> </dl> <div align="right"><a href="#top">Up</a></div>