--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/eric6/E5Gui/E5FileDialog.py Sun Apr 14 15:09:21 2019 +0200
@@ -0,0 +1,220 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2010 - 2019 Detlev Offenbach <detlev@die-offenbachs.de>
+#
+
+"""
+Module implementing alternative functions for the QFileDialog static methods
+to cope with distributor's usage of KDE wrapper dialogs for Qt file dialogs.
+"""
+
+from __future__ import unicode_literals
+
+from PyQt5.QtCore import PYQT_VERSION_STR
+from PyQt5.QtWidgets import QFileDialog
+
+import Globals
+
+Options = QFileDialog.Options
+Option = QFileDialog.Option
+
+ShowDirsOnly = QFileDialog.ShowDirsOnly
+DontResolveSymlinks = QFileDialog.DontResolveSymlinks
+DontConfirmOverwrite = QFileDialog.DontConfirmOverwrite
+DontUseNativeDialog = QFileDialog.DontUseNativeDialog
+ReadOnly = QFileDialog.ReadOnly
+HideNameFilterDetails = QFileDialog.HideNameFilterDetails
+DontUseSheet = QFileDialog.DontUseSheet
+
+
+def __reorderFilter(filterStr, initialFilter=""):
+ """
+ Private function to reorder the file filter to cope with a KDE issue
+ introduced by distributor's usage of KDE file dialogs.
+
+ @param filterStr Qt file filter (string)
+ @param initialFilter initial filter (string)
+ @return the rearranged Qt file filter (string)
+ """
+ if initialFilter and not Globals.isMacPlatform():
+ fileFilters = filterStr.split(';;')
+ if len(fileFilters) < 10 and initialFilter in fileFilters:
+ fileFilters.remove(initialFilter)
+ fileFilters.insert(0, initialFilter)
+ return ";;".join(fileFilters)
+ else:
+ return filterStr
+
+
+def getOpenFileName(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get the name of a file for opening it.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return name of file to be opened (string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getOpenFileName(
+ parent, caption, directory, filterStr, "", options)[0]
+ else:
+ return QFileDialog.getOpenFileName(
+ parent, caption, directory, filterStr, options)
+
+
+def getOpenFileNameAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get the name of a file for opening it and the selected
+ file name filter.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param initialFilter initial filter for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return name of file to be opened and selected filter (string, string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getOpenFileName(
+ parent, caption, directory, newfilter, initialFilter, options)
+ else:
+ return QFileDialog.getOpenFileNameAndFilter(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getOpenFileNames(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get a list of names of files for opening.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return list of file names to be opened (list of string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getOpenFileNames(
+ parent, caption, directory, filterStr, "", options)[0]
+ else:
+ return QFileDialog.getOpenFileNames(
+ parent, caption, directory, filterStr, options)
+
+
+def getOpenFileNamesAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get a list of names of files for opening and the
+ selected file name filter.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param initialFilter initial filter for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return list of file names to be opened and selected filter
+ (list of string, string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getOpenFileNames(
+ parent, caption, directory, newfilter, initialFilter, options)
+ else:
+ return QFileDialog.getOpenFileNamesAndFilter(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getSaveFileName(parent=None, caption="", directory="",
+ filterStr="", options=None):
+ """
+ Module function to get the name of a file for saving it.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return name of file to be saved (string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getSaveFileName(
+ parent, caption, directory, filterStr, "", options)[0]
+ else:
+ return QFileDialog.getSaveFileName(
+ parent, caption, directory, filterStr, options)
+
+
+def getSaveFileNameAndFilter(parent=None, caption="", directory="",
+ filterStr="", initialFilter="",
+ options=None):
+ """
+ Module function to get the name of a file for saving it and the selected
+ file name filter.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param filterStr filter string for the dialog (string)
+ @param initialFilter initial filter for the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return name of file to be saved and selected filter (string, string)
+ """
+ if options is None:
+ options = QFileDialog.Options()
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ newfilter = __reorderFilter(filterStr, initialFilter)
+ if PYQT_VERSION_STR >= "5.0.0":
+ return QFileDialog.getSaveFileName(
+ parent, caption, directory, newfilter, initialFilter, options)
+ else:
+ return QFileDialog.getSaveFileNameAndFilter(
+ parent, caption, directory, newfilter, initialFilter, options)
+
+
+def getExistingDirectory(parent=None, caption="",
+ directory="", options=QFileDialog.ShowDirsOnly):
+ """
+ Module function to get the name of a directory.
+
+ @param parent parent widget of the dialog (QWidget)
+ @param caption window title of the dialog (string)
+ @param directory working directory of the dialog (string)
+ @param options various options for the dialog (QFileDialog.Options)
+ @return name of selected directory (string)
+ """
+ if Globals.isLinuxPlatform():
+ options |= QFileDialog.DontUseNativeDialog
+ return QFileDialog.getExistingDirectory(parent, caption, directory,
+ options)
