Skip to content

QtActiveOverlay#

Animated busy indicators for lightweight in-place activity feedback.

Screenshot#

qt active overlay

Example#

Source: examples/qt_active_overlay.py

from qtpy.QtWidgets import QApplication, QVBoxLayout, QWidget

from qtextra.config import THEMES
from qtextra.widgets.qt_active_overlay import QtActiveOverlay, QtActiveWidget

app = QApplication([])

widget = QWidget()
THEMES.apply(widget)

layout = QVBoxLayout()
widget.setLayout(layout)

# QtActiveOverlay displays dots that are animated to show progress
layout.addWidget(
    QtActiveOverlay(
        n_dots=7,
        interval=100,  # in milliseconds
        size=30,  # size of dots
    ),
)

# QtActiveWidget is simple widget with GIF playing in an infinite loop
layout.addWidget(
    QtActiveWidget(
        text="Action in progress...",
        size=(128, 128),
        which="infinity",  # also choose from dots, oval, circle, square
    ),
)

widget.show()
app.exec_()

Notes#

  • Use QtActiveOverlay for a compact inline animated indicator made of dots.
  • Use QtActiveWidget when you want a larger spinner or loading illustration with text.

API#

Qt Class#

QWidget

Methods#

Widget that displays that action is in progress.

INTERVAL: int = interval class-attribute instance-attribute #

N_DOTS: int = n_dots class-attribute instance-attribute #

REVERSE: bool = False class-attribute instance-attribute #

SIZE = size class-attribute instance-attribute #

SPACING = spacing class-attribute instance-attribute #

counter: int = 0 class-attribute instance-attribute #

timer_id: int | None = None class-attribute instance-attribute #

Qt Class#

QWidget