def askopendirnames(parent=None, title=_("Open"), **kwargs):
"""
Return () or the tuple of the absolute paths of the chosen directories
Options:
* initialdir: initial folder whose content is displayed
* initialfile: initial selected item (just the name, not the full path)
* filetypes: [('name', '*.ext1|*.ext2|..'), ...]
show only files of given filetype ("*" for all files)
* okbuttontext: text displayed on the validate button, if None, the
default text corresponding to the mode is used (either Open or Save)
* cancelbuttontext: text displayed on the button that cancels the
selection.
* foldercreation: enable the user to create new folders if True (default)
"""
dialog = FileBrowser(parent,
mode="opendir",
multiple_selection=True,
title=title,
**kwargs)
dialog.wait_window(dialog)
res = dialog.get_result()
if not res: # type consistency: always return a tuple
res = ()
return res
def askopendirnames(parent=None, title=_("Open"), **kwargs):
"""
Return :obj:`()` or the tuple of the absolute paths of the chosen directories
Arguments:
parent : Tk or Toplevel instance
parent window
title : str
the title of the filebrowser window
initialdir : str
directory whose content is initially displayed
initialfile : str
initially selected item (just the name, not the full path)
filetypes : list :obj:`[("name", "*.ext1|*.ext2|.."), ...]`
only the files of given filetype will be displayed,
e.g. to allow the user to switch between displaying only PNG or JPG
pictures or dispalying all files:
:obj:`filtypes=[("Pictures", "\*.png|\*.PNG|\*.jpg|\*.JPG'), ("All files", "\*")]`
okbuttontext : str
text displayed on the validate button, default is "Open".
cancelbuttontext : str
text displayed on the button that cancels the selection, default is "Cancel".
foldercreation : bool
enable the user to create new folders if True (default)
"""
dialog = FileBrowser(parent,
mode="opendir",
multiple_selection=True,
title=title,
**kwargs)
dialog.wait_window(dialog)
res = dialog.get_result()
if not res: # type consistency: always return a tuple
res = ()
return res
def asksaveasfilename(parent=None, title=_("Save As"), **kwargs):
"""
Return '' or the chosen absolute path (the file might not exist)
Options:
* initialdir: initial folder whose content is displayed
* initialfile: initial selected item (just the name, not the full path)
* defaultext (save mode only): extension added to filename if none is given
* filetypes: [('name', '*.ext1|*.ext2|..'), ...]
show only files of given filetype ("*" for all files)
* okbuttontext: text displayed on the validate button, if None, the
default text corresponding to the mode is used (either Open or Save)
* cancelbuttontext: text displayed on the button that cancels the
selection.
* foldercreation: enable the user to create new folders if True (default)
"""
dialog = FileBrowser(parent, mode="save", title=title, **kwargs)
dialog.wait_window(dialog)
return dialog.get_result()
def asksaveasfilename(parent=None, title=_("Save As"), **kwargs):
"""
Return :obj:`''` or the chosen path (the file might not exist)
Arguments:
parent : Tk or Toplevel instance
parent window
title : str
the title of the filebrowser window
initialdir : str
directory whose content is initially displayed
initialfile : str
initially selected item (just the name, not the full path)
defaultext : str (e.g. '.png')
extension added to filename if none is given (default is none)
filetypes : list :obj:`[("name", "*.ext1|*.ext2|.."), ...]`
only the files of given filetype will be displayed,
e.g. to allow the user to switch between displaying only PNG or JPG
pictures or dispalying all files:
:obj:`filtypes=[("Pictures", "\*.png|\*.PNG|\*.jpg|\*.JPG'), ("All files", "\*")]`
okbuttontext : str
text displayed on the validate button, default is "Open".
cancelbuttontext : str
text displayed on the button that cancels the selection, default is "Cancel".
foldercreation : bool
enable the user to create new folders if True (default)
"""
dialog = FileBrowser(parent, mode="save", title=title, **kwargs)
dialog.wait_window(dialog)
return dialog.get_result()
