enaml.widgets.file_dialog

Classes

A dialog widget that allows the user to open and save files and directories.

class enaml.widgets.file_dialog.FileDialog(parent=None, **kwargs)[source]

A dialog widget that allows the user to open and save files and directories.

path: The selected path in the dialog. This value will be used to set the initial working directory and file, as appropriate, when the dialog is opened. It will aslo be updated when the dialog is closed and accepted.

paths: The list of selected paths in the dialog. It will be updated when the dialog is closed and accepted. It is output only and is only applicable for the open_files mode.

selected_filter: The selected filter from the list of filters. This value will be used as the initial working filter when the dialog is opened. It will also be updated when the dialog is closed and accepted.

native_dialog: Whether to use a platform native dialog, when available. This attribute is deprecated and no longer has any effect. Native dialogs are always used when available in a given toolkit.

result: An enum indicating if the dialog was accepted or rejected by the user. It will be updated when the dialog is closed. This value is output only.

callback: An optional callback which will be invoked when the dialog is closed. This is a convenience to make it easier to handle a dialog opened in non-blocking mode. The callback must accept a single argument, which will be the dialog instance.

accepted: An event fired if the dialog is accepted. The payload will be the selected path.

destroy_on_close: Whether to destroy the dialog widget on close. The default is True since dialogs are typically used in a transitory fashion.

Open the dialog in a non-blocking fashion.

This method will always return None. The state of the dialog will be updated when the dialog is closed by the user.

Open the dialog in a blocking fashion.

Returns:: result – The path selected by the user, or an empty string if the dialog is cancelled.
Return type:: unicode