dip.toolkits.qt4

This module contains the implementation of the Qt4 toolkit.

Toolkit

class dip.toolkits.qt4.Toolkit

Base class: BaseToolkit

The Toolkit class implements the toolkit that uses the Qt4 GUI library.

action(parent)

Create an action, i.e. an object that implements the IAction interface.

Parameters:parent – is the optional parent view.
Returns:the action. The unadapted object will be an instance of QAction.
application(argv, **properties)

Create a singleton application, i.e. an object that implements the IApplication interface.

Parameters:
  • argv – is the sequence of command line arguments.
  • **properties – are the keyword arguments used as toolkit specific property names and values that are used to configure the application.
Returns:

the application. Repeated calls must return the same application. The unadapted object will be an instance of QApplication.

check_box(parent)

Create an editor that implements the ICheckBox interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QCheckBox.
close_action()

Create an action, i.e. an object that implements the IAction interface, to handle closing an object.

Returns:the action. The unadapted object will be an instance of QAction.
combo_box(parent)

Create an editor that implements the IComboBox interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QComboBox.
designer_load(ui_file_name)

Load a file containing a user interface design.

Parameters:ui_file_name – is the name of the file.
Returns:an opaque object that will be passed to designer_view().
designer_view(design, parent)

Create a view from a previously loaded user interface design.

Parameters:
  • design – is an opaque object returned by a previous call to designer_load().
  • parent – is the optional parent view.
Returns:

the view.

dialog(parent)

Create a view that implements the IDialog interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapated object will be an instance of QDialog.
displayable(view)

Return a view that can be displayed as a top-level window.

Parameters:view – is the view to be displayed.
Returns:the view, possibly wrapped so that it can be displayed.
dock(parent)

Create a view that implements the IDock interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QDockWidget.
filesystem_location_editor(parent)

Create an editor that implements the IFilesystemLocationEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of DipFilesystemLocationEditor. Any factory properties will be applied to an internal QLineEdit.
find_toolkit_view(toolkit_root, id)

Find the toolkit view with a particular identifier.

Parameters:
  • toolkit_root – is the root toolkit view to begin the search.
  • id – is the identifier of the view to search for.
Returns:

the toolkit view. An exception will be raised if the view could not be found.

float_spin_box(parent)

Create an editor that implements the IFloatSpinBox interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QDoubleSpinBox.
form(parent)

Create a view that implements the IForm interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QFormLayout.
get_open_file(window_title, directory='', filter='', parent=None)

Get the name of a file to open from the user.

Parameters:
  • window_title – is the window title, typically used as the title of a dialog.
  • directory – is the name of an optional initial directory or file.
  • filter – is the optional file filter.
  • parent – is the optional parent view.
Returns:

the name of the file to open or an empty string if there was none.

get_save_file(window_title, directory='', filter='', parent=None)

Get the name of a file to save from the user.

Parameters:
  • window_title – is the window title, typically used as the title of a dialog.
  • directory – is the name of an optional initial directory or file.
  • filter – is the optional file filter.
  • parent – is the optional parent view.
Returns:

the name of the file to save or an empty string if there was none.

grid(parent)

Create a view that implements the IGrid interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QGridLayout.
group_box(parent)

Create a view that implements the IGroupBox interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QGroupBox.
h_box(parent)

Create a view that implements the IHBox interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QHBoxLayout.
information(window_title, text, parent)

Display a informational message to the user.

Parameters:
  • window_title – is the window title, typically used as the title of a dialog.
  • text – is the text of the message.
  • parent – is the optional parent view.
label(parent)

Create an editor that implements the ILabel interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QLabel.
line_editor(parent)

Create an editor that implements the ILineEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QLineEdit.
list_editor(parent)

Create an editor that implements the IListEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of DipListEditor. Any factory properties will be applied to an internal QTreeWidget.
main_window(parent)

Create a view that implements the IMainWindow interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QMainWindow.
menu(parent)

Create a view that implements the IMenu interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QMenu.
menu_bar(parent)

Create a view that implements the IMenuBar interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QMenuBar.
message_area(parent)

Create a view that implements the IMessageArea interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QLabel.
new_action()

Create an action, i.e. an object that implements the IAction interface, to handle creating a new object.

Returns:the action. The unadapted object will be an instance of QAction.
open_action()

Create an action, i.e. an object that implements the IAction interface, to handle opening an object.

Returns:the action. The unadapted object will be an instance of QAction.
option_list(parent)

Create an editor that implements the IOptionList interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QListWidget.
push_button(parent)

Create an that implements the IPushButton interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QPushButton.
question(window_title, text, parent, detail, buttons)

Ask the user a question.

Parameters:
  • window_title – is the window title, typically used as the title of a dialog.
  • text – is the text of the question.
  • parent – is the optional parent view.
  • detail – is the optional additional detail.
  • buttons – is the sequence of buttons to display. Possible buttons are ‘yes’, ‘no’, ‘cancel’, ‘save’ and ‘discard’. The first in the sequence is used as the default.
Returns:

The button that was pressed.

quit_action()

Create an action, i.e. an object that implements the IAction interface, to handle quitting the application.

Returns:the action. The unadapted object will be an instance of QAction.
radio_buttons(parent)

Create an editor that implements the IRadioButtons interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of DipRadioButtons. Any factory properties will be applied to each of the buttons.
save_action()

Create an action, i.e. an object that implements the IAction interface, to handle saving an object.

Returns:the action. The unadapted object will be an instance of QAction.
save_as_action()

Create an action, i.e. an object that implements the IAction interface, to handle saving an object under a new name.

Returns:the action. The unadapted object will be an instance of QAction.
settings(organization, application)

Create a settings object, i.e. an object that implements the ISettingsStorage interface.

Parameters:
  • organization – the name of the organization.
  • application – the name of the application.
Returns:

the settings object.

spin_box(parent)

Create an editor that implements the ISpinBox interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QSpinBox.
splitter(parent)

Create a view that implements the ISplitter interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QSplitter.
storage_location_editor(parent)

Create an editor that implements the IStorageLocationEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of DipStorageLocationEditor. Any factory properties will be applied to an internal QLineEdit.
tab_bar(parent)

Create a view that implements the ITabBar interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QTabWidget.
tab_page(parent)

Create a view that implements the ITabPage interface.

Parameters:parent – is the optional parent view.
Returns:the view.
table_editor(parent)

Create an editor that implements the ITableEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of DipTableEditor. Any factory properties will be applied to an internal QTableWidget.
text_editor(parent)

Create an editor that implements the ITextEditor interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QTextEdit.
tool_button(parent)

Create an editor that implements the IToolButton interface.

Parameters:parent – is the optional parent view.
Returns:the editor. The unadapted object will be an instance of QToolButton.
v_box(parent)

Create a view that implements the IVBox interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QVBoxLayout.
view_stack(parent)

Create a view that implements the IViewStack interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QStackedLayout.
warning(window_title, text, parent, detail)

Display a warning message to the user.

Parameters:
  • window_title – is the window title, typically used as the title of a dialog.
  • text – is the text of the warning.
  • parent – is the optional parent view.
  • detail – is the optional additional detail.
whats_this_action()

Create an action, i.e. an object that implements the IAction interface, to handle “What’s This?”.

Returns:the action. The unadapted object will be an instance of QAction.
wizard(parent)

Create a view that implements the IWizard interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QWizard.
wizard_page(parent)

Create a view that implements the IWizardPage interface.

Parameters:parent – is the optional parent view.
Returns:the view. The unadapted object will be an instance of QWizardPage.