Custom Tabs

class UI4.Tabs.BaseTab(parent, flags=0, deprecatedBy=None)

Bases: UI4.Widgets.BaseWidgets.BaseFrame

Base class for all UI tabs.

Inherits from BaseFrame to provide handling of custom callbacks for actions and key events that are associated with user-defined keyboard shortcuts, and provides functions for storing and restoring settings per tab when loading and saving tab layouts.

__init__(parent, flags=0, deprecatedBy=None)

Initializes an instance of the class.

Parameters:
  • parent (QtWidgets.QWidget or None) – The parent widget to own the new instance. Passed verbatim to the base class initializer.
  • flags (QtCore.Qt.WindowFlags) – The window flags to use in case no parent is given. Passed wrapped in QtCore.Qt.WindowFlags() to the BaseFrame base class initializer.
  • deprecatedBy (str or None) – The name of a type of tab that is to be used instead of an instance of a specific class that is derived from the BaseTab class.
applySettings(settings)

Applies the given settings to the tab.

Is called when creating a tab of the type represented by a class derived from BaseTab.

Parameters:settings (dict) – A dictionary of settings to apply to this tab.
Note:The default implementation does nothing.
closeEvent(event)

This event handler is called with the given event when the tab receives a window close request. A signal is emitted when the tab gets closed which would then a child widget could pick up to unregister any of its registered event handlers.

Parameters:event (QtGui.QCloseEvent) – Event sent to widgets that the user wants to close.
getMenuBar()
Return type:QtWidgets.QMenuBar or None
Returns:The tab’s menu bar, or None if the tab does not provide a menu bar.
getSettings()
Return type:dict
Returns:A dictionary of settings that should be stored and restored as part of a tab layout.
Note:The default implementation returns an empty dictionary.
getTabTitle()
Return type:str or None
Returns:A specific title to use for this tab, or None to use a title that matches the type of the tab.
on_animation_finished()

Slot that is called when the animation for hiding the deprecation warning frame has finished.

Removes the deprecation warning frame from the tab’s layout and deletes it.

on_dismissButton_clicked()

Slot that is called when the Dismiss button in the deprecation warning frame has been clicked.

Adds the title of this type of tab to the list of titles of tabs whose deprecation warnings have been dismissed that is stored in the user’s preferences.

on_replaceTabButton_clicked()

Slot that is called when the Replace button has been clicked.

Replaces this tab with a tab of the type by which this type of tab has been deprecated.

showEvent(event)

Event handler for widget show events.

Parameters:event (QtGui.QShowEvent) – An object containing details about the widget show event to process.
tabClosed