Skip to content

cellects.gui.custom_widgets

cellects.gui.custom_widgets

This module contains all modified/simplified widgets from PySide6 It is made to be easier to use and to be consistant in terms of colors and sizes.

MainTabsWidget

Bases: QPushButton

A custom QPushButton that mimics an explorer tab appearance.

Features: - Customizable text - Night mode support - Three states: not_in_use (grey border), in_use (black border), not_usable (grey text) - Tooltip support for not_usable state

Source code in src/cellects/gui/custom_widgets.py 
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
class MainTabsWidget(QtWidgets.QPushButton):
    """
    A custom QPushButton that mimics an explorer tab appearance.

    Features:
    - Customizable text
    - Night mode support
    - Three states: not_in_use (grey border), in_use (black border), not_usable (grey text)
    - Tooltip support for not_usable state
    """

    def __init__(self, text="", night_mode=False, parent=None):
        super().__init__()

        self.setText(text)
        self.state = "not_in_use"  # States: "not_in_use", "in_use", "not_usable"
        self.setFont(buttonfont)

        # Set basic properties
        self.setSizePolicy(QtWidgets.QSizePolicy.Minimum, QtWidgets.QSizePolicy.Fixed)
        self.setFixedHeight(35)
        self.setCursor(QtCore.Qt.CursorShape.PointingHandCursor)

        self.night_mode_switch(night_mode)


    def night_mode_switch(self, night_mode):
        self._night_mode = night_mode
        self.update_style()

    def update_style(self):
        """Update the widget's stylesheetµ"""

        if self.state == "not_usable":
            tab_text_color = "#888888"
            self.setCursor(QtCore.Qt.CursorShape.ForbiddenCursor)
        else:
            if self._night_mode:
                tab_text_color = night_text_Color
            else:
                tab_text_color = textColor
            if self.state == "not_in_use":
                self.setCursor(QtCore.Qt.CursorShape.PointingHandCursor)
        if self.state == "in_use":
            border_width = 2
            if self._night_mode:
                tab_border = f"{border_width}px solid #adadad"
            else:
                tab_border = f"{border_width}px solid #323241"
        else:
            border_width = 1
            if self._night_mode:
                tab_border = f"{border_width}px solid #323241"
            else:
                tab_border = f"{border_width}px solid #adadad"

        if self._night_mode:
            style = {"buttoncolor": night_button_color, "buttontextColor": tab_text_color, "border": tab_border,
                     "font_family": tabfont, "font_size": "22pt", #"font_weight": "bold",
                     "border-top-color": "#323241", "border-right-color": "#323241", # invisible
                     "border-top-left-radius": "10", "border-bottom-left-radius": "1"}
        else:
            style = {"buttoncolor": buttoncolor, "buttontextColor": tab_text_color, "border": tab_border,
                     "font_family": tabfont, "font_size": "22pt", #"font_weight": "bold",
                     "border-top-color": "#ffffff", "border-right-color": "#ffffff", # invisible
                     "border-top-left-radius": "10", "border-bottom-left-radius": "1"
                     }
        self.setStyleSheet(
            "background-color: %s; color: %s; border: %s; font-family: %s; font-size: %s;  border-top-color: %s; border-right-color: %s; border-top-left-radius: %s; border-bottom-left-radius: %s" % tuple(style.values()))


    def set_in_use(self):
        """Set the tab to 'in_use' state with black border."""
        self.state = "in_use"
        self.setToolTip("")  # Clear any tooltip
        self.update_style()

    def set_not_in_use(self):
        """Set the tab to 'not_in_use' state with grey border."""
        self.state = "not_in_use"
        self.setToolTip("")  # Clear any tooltip
        self.update_style()

    def set_not_usable(self, tooltip_text="This tab is not usable"):
        """
        Set the tab to 'not_usable' state with grey text.

        Args:
            tooltip_text (str): Custom tooltip text to show when hovering
        """
        self.state = "not_usable"
        self.setToolTip(tooltip_text)
        self.update_style()

    def get_state(self):
        """Get the current state of the tab."""
        return self.state

    def is_night_mode(self):
        """Check if night mode is enabled."""
        return self._night_mode

get_state()

Get the current state of the tab.

Source code in src/cellects/gui/custom_widgets.py 
670
671
672
def get_state(self):
    """Get the current state of the tab."""
    return self.state

is_night_mode()

Check if night mode is enabled.

Source code in src/cellects/gui/custom_widgets.py 
674
675
676
def is_night_mode(self):
    """Check if night mode is enabled."""
    return self._night_mode

set_in_use()

Set the tab to 'in_use' state with black border.

Source code in src/cellects/gui/custom_widgets.py 
647
648
649
650
651
def set_in_use(self):
    """Set the tab to 'in_use' state with black border."""
    self.state = "in_use"
    self.setToolTip("")  # Clear any tooltip
    self.update_style()

set_not_in_use()

Set the tab to 'not_in_use' state with grey border.

Source code in src/cellects/gui/custom_widgets.py 
653
654
655
656
657
def set_not_in_use(self):
    """Set the tab to 'not_in_use' state with grey border."""
    self.state = "not_in_use"
    self.setToolTip("")  # Clear any tooltip
    self.update_style()

set_not_usable(tooltip_text='This tab is not usable')

Set the tab to 'not_usable' state with grey text.

Args: tooltip_text (str): Custom tooltip text to show when hovering

Source code in src/cellects/gui/custom_widgets.py 
659
660
661
662
663
664
665
666
667
668
def set_not_usable(self, tooltip_text="This tab is not usable"):
    """
    Set the tab to 'not_usable' state with grey text.

    Args:
        tooltip_text (str): Custom tooltip text to show when hovering
    """
    self.state = "not_usable"
    self.setToolTip(tooltip_text)
    self.update_style()

update_style()

Update the widget's stylesheetµ

Source code in src/cellects/gui/custom_widgets.py 
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
def update_style(self):
    """Update the widget's stylesheetµ"""

    if self.state == "not_usable":
        tab_text_color = "#888888"
        self.setCursor(QtCore.Qt.CursorShape.ForbiddenCursor)
    else:
        if self._night_mode:
            tab_text_color = night_text_Color
        else:
            tab_text_color = textColor
        if self.state == "not_in_use":
            self.setCursor(QtCore.Qt.CursorShape.PointingHandCursor)
    if self.state == "in_use":
        border_width = 2
        if self._night_mode:
            tab_border = f"{border_width}px solid #adadad"
        else:
            tab_border = f"{border_width}px solid #323241"
    else:
        border_width = 1
        if self._night_mode:
            tab_border = f"{border_width}px solid #323241"
        else:
            tab_border = f"{border_width}px solid #adadad"

    if self._night_mode:
        style = {"buttoncolor": night_button_color, "buttontextColor": tab_text_color, "border": tab_border,
                 "font_family": tabfont, "font_size": "22pt", #"font_weight": "bold",
                 "border-top-color": "#323241", "border-right-color": "#323241", # invisible
                 "border-top-left-radius": "10", "border-bottom-left-radius": "1"}
    else:
        style = {"buttoncolor": buttoncolor, "buttontextColor": tab_text_color, "border": tab_border,
                 "font_family": tabfont, "font_size": "22pt", #"font_weight": "bold",
                 "border-top-color": "#ffffff", "border-right-color": "#ffffff", # invisible
                 "border-top-left-radius": "10", "border-bottom-left-radius": "1"
                 }
    self.setStyleSheet(
        "background-color: %s; color: %s; border: %s; font-family: %s; font-size: %s;  border-top-color: %s; border-right-color: %s; border-top-left-radius: %s; border-bottom-left-radius: %s" % tuple(style.values()))

PButton

Bases: QPushButton

Source code in src/cellects/gui/custom_widgets.py 
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
class PButton(QtWidgets.QPushButton):
    def __init__(self, text, fade=True, tip=None, night_mode=False):
        """

        self.setStyleSheet("background-color: rgb(107, 145, 202);\n"
                                "border-color: rgb(255, 255, 255);\n"
                                "color: rgb(0, 0, 0);\n"
                                "font: 17pt \"Britannic Bold\";")
        :param text:
        """
        super().__init__()
        self.setText(text)
        self.setToolTip(tip)
        self.night_mode_switch(night_mode)
        self.setFont(buttonfont)
        self.setSizePolicy(QtWidgets.QSizePolicy.Fixed, QtWidgets.QSizePolicy.Fixed)
        self.setFixedWidth(len(text)*15 + 25)
        self.setCursor(QtCore.Qt.CursorShape.PointingHandCursor)

    def night_mode_switch(self, night_mode):
        if night_mode:
            self.style = {"buttoncolor": night_button_color, "buttontextColor": night_text_Color, "buttonborder": night_button_border,
                          "buttonangles": buttonangles}
        else:
            self.style = {"buttoncolor": buttoncolor, "buttontextColor": textColor, "buttonborder": buttonborder,
                          "buttonangles": buttonangles}
        self.update_style()

    def event_filter(self, event):
        if event.type() == QtCore.QEvent.MouseMove:
            if event.buttons() == QtCore.Qt.NoButton:
                self.fade()
            else:
                self.unfade()

    def update_style(self):
        self.setStyleSheet(
            "background-color: %s; color: %s; border: %s; border-radius: %s" % tuple(self.style.values()))

    def color(self, color):
        self.style["buttoncolor"] = color
        self.update_style()

    def textcolor(self, textcolor):
        self.style["buttontextColor"] = textcolor
        self.update_style()

    def border(self, border):
        self.style["buttonborder"] = border
        self.update_style()

    def angles(self, angles):
        self.style["buttonangles"] = angles
        self.update_style()

    def fade(self):
        self.setWindowOpacity(0.5)
        self.setStyleSheet("background-color: %s; color: %s; border: %s; border-radius: %s" % (buttonclickedcolor, textColor, buttonborder, buttonangles))
        QtCore.QTimer.singleShot(300, self.unfade)

    def unfade(self):
        self.setWindowOpacity(1)
        self.setStyleSheet("background-color: %s; color: %s; border: %s; border-radius: %s" % (buttoncolor, textColor, buttonborder, buttonangles))

__init__(text, fade=True, tip=None, night_mode=False) 

    self.setStyleSheet("background-color: rgb(107, 145, 202);

" "border-color: rgb(255, 255, 255); " "color: rgb(0, 0, 0); " "font: 17pt "Britannic Bold";") :param text:

Source code in src/cellects/gui/custom_widgets.py 
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
def __init__(self, text, fade=True, tip=None, night_mode=False):
    """

    self.setStyleSheet("background-color: rgb(107, 145, 202);\n"
                            "border-color: rgb(255, 255, 255);\n"
                            "color: rgb(0, 0, 0);\n"
                            "font: 17pt \"Britannic Bold\";")
    :param text:
    """
    super().__init__()
    self.setText(text)
    self.setToolTip(tip)
    self.night_mode_switch(night_mode)
    self.setFont(buttonfont)
    self.setSizePolicy(QtWidgets.QSizePolicy.Fixed, QtWidgets.QSizePolicy.Fixed)
    self.setFixedWidth(len(text)*15 + 25)
    self.setCursor(QtCore.Qt.CursorShape.PointingHandCursor)

WindowType

Bases: QWidget

Source code in src/cellects/gui/custom_widgets.py 
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
class WindowType(QtWidgets.QWidget):
    resized = QtCore.Signal()
    def __init__(self, parent, night_mode=False):
        super().__init__()

        self.thread_dict = {}
        self.setVisible(False)
        self.setParent(parent)
        self.frame = QtWidgets.QFrame(self)
        self.frame.setGeometry(QtCore.QRect(0, 0, self.parent().screen_width, self.parent().screen_height))
        self.display_image = None
        self.setFont(QFont(textfont, textsize, QFont.Medium))
        self.night_mode = night_mode
        self.night_mode_switch(night_mode)

    def resizeEvent(self, event):
        '''
        # Use this signal to detect a resize event and call center window function
        :param event:
        :return:
        '''
        self.resized.emit()
        self.night_mode_switch(self.night_mode)
        if self.display_image is not None:
            win_width, win_height = self.size().width(), self.size().height()
            self.display_image.max_width = win_width - self.parent().image_window_width_diff
            self.display_image.max_height = win_height - self.parent().image_window_height_diff
            if self.display_image.max_width * self.display_image.height_width_ratio < self.display_image.max_height:
                self.display_image.scaled_shape = [round(self.display_image.max_width * self.display_image.height_width_ratio), self.display_image.max_width]
            else:
                self.display_image.scaled_shape = [self.display_image.max_height, np.round(self.display_image.max_height / self.display_image.height_width_ratio)]

            self.display_image.setMaximumHeight(self.display_image.scaled_shape[0])
            self.display_image.setMaximumWidth(self.display_image.scaled_shape[1])
        return super(WindowType, self).resizeEvent(event)

    def center_window(self):
        self.parent().center()

    def night_mode_switch(self, night_mode):
        if night_mode:
            self.setStyleSheet(
                "background-color: %s; color: %s; font: %s; selection-color: %s; selection-background-color: %s" % (
                night_background_color, night_text_Color, f"{textsize}pt {textfont};",
                night_selection_color, night_selection_background_color))
        else:
            self.setStyleSheet(
                "background-color: %s; color: %s; font: %s; selection-color: %s; selection-background-color: %s" % (
                backgroundcolor, textColor, f"{textsize}pt {textfont};", selectioncolor,
                selectionbackgroundcolor))

resizeEvent(event)

Use this signal to detect a resize event and call center window function

:param event: :return:

Source code in src/cellects/gui/custom_widgets.py 
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
def resizeEvent(self, event):
    '''
    # Use this signal to detect a resize event and call center window function
    :param event:
    :return:
    '''
    self.resized.emit()
    self.night_mode_switch(self.night_mode)
    if self.display_image is not None:
        win_width, win_height = self.size().width(), self.size().height()
        self.display_image.max_width = win_width - self.parent().image_window_width_diff
        self.display_image.max_height = win_height - self.parent().image_window_height_diff
        if self.display_image.max_width * self.display_image.height_width_ratio < self.display_image.max_height:
            self.display_image.scaled_shape = [round(self.display_image.max_width * self.display_image.height_width_ratio), self.display_image.max_width]
        else:
            self.display_image.scaled_shape = [self.display_image.max_height, np.round(self.display_image.max_height / self.display_image.height_width_ratio)]

        self.display_image.setMaximumHeight(self.display_image.scaled_shape[0])
        self.display_image.setMaximumWidth(self.display_image.scaled_shape[1])
    return super(WindowType, self).resizeEvent(event)