Skip to content

visualdynamics.gui.message_bar

message_bar

The window's status bar, its message text that can be selected and copied.

Qt's status bar paints a message itself, as a picture of the text, so a refusal or a reading could be read but not copied into a note or a report. Here the message is a label that can be selected with the mouse and copied with Cmd+C (Ctrl+C elsewhere) or its right-click menu, and showMessage, currentMessage and clearMessage keep their meanings, so nothing that writes or reads the bar changes. A message no longer hides the bar's left-hand widgets either, which Qt's own does.

Classes:

Name Description
MessageBar

A status bar whose message is selectable text.

Classes

MessageBar 

MessageBar(parent: QWidget | None = None)

Bases: QStatusBar

A status bar whose message is selectable text.

Methods:

Name Description
showMessage

Show text until the next message; timeout is not used.
currentMessage

The message shown.
clearMessage

Show no message.
Source code in src/visualdynamics/gui/message_bar.py 
25
26
27
28
29
30
31
32
33
34
35
36
def __init__(self, parent: QWidget | None = None) -> None:
    super().__init__(parent)
    self._message = ''
    self.label: QLabel = QLabel()
    self.label.setTextInteractionFlags(Qt.TextInteractionFlag.TextSelectableByMouse
                                       | Qt.TextInteractionFlag.TextSelectableByKeyboard)
    self.label.setTextFormat(Qt.TextFormat.PlainText)
    # a long message is cut at the bar's edge rather than widening the
    # window; the whole of it is in the tooltip and in what is copied
    self.label.setSizePolicy(QSizePolicy.Policy.Ignored, QSizePolicy.Policy.Preferred)
    self.label.setMinimumWidth(0)
    self.addWidget(self.label, 1)
Methods:
showMessage 
showMessage(text: str, timeout: int = 0) -> None

Show text until the next message; timeout is not used.

Source code in src/visualdynamics/gui/message_bar.py 
38
39
40
41
42
43
def showMessage(self, text: str, timeout: int = 0) -> None:
    """Show `text` until the next message; `timeout` is not used."""
    self._message = str(text)
    self.label.setText(self._message)
    self.label.setToolTip(self._message)
    self.messageChanged.emit(self._message)
currentMessage 
currentMessage() -> str

The message shown.

Source code in src/visualdynamics/gui/message_bar.py 
45
46
47
def currentMessage(self) -> str:
    """The message shown."""
    return self._message
clearMessage 
clearMessage() -> None

Show no message.

Source code in src/visualdynamics/gui/message_bar.py 
49
50
51
def clearMessage(self) -> None:
    """Show no message."""
    self.showMessage('')