Scroll Area
SingleDirectionScrollArea
SingleDirectionScrollArea implements smooth scrolling in a single direction. This component can be used when there is too much data to display in the vertical or horizontal direction.
Vertical direction:
scrollArea = SingleDirectionScrollArea(orient=Qt.Vertical)
scrollArea.resize(200, 400)
# There are many components in the vertical direction
view = QWidget()
layout = QVBoxLayout(view)
for i in range(1, 100):
layout.addWidget(QPushButton(f"Button {i}"))
scrollArea.setWidget(view)
Horizontal direction:
scrollArea = SingleDirectionScrollArea(orient=Qt.Horizontal)
scrollArea.resize(400, 150)
# There are many components in the horizontal direction
view = QWidget()
layout = QHBoxLayout(view)
for i in range(1, 100):
layout.addWidget(QPushButton(f"Button {i}"))
scrollArea.setWidget(view)
By default, the background and border of the scroll area are opaque. To change to a transparent background and remove the border:
scrollArea.setStyleSheet("QScrollArea{background: transparent; border: none}")
# You must also add a transparent background style to the internal view
view.setStyleSheet("QWidget{background: transparent}")
You can also enable transparent background by api, note that this api must be called after scrollArea.setWidget(view):
scrollArea.enableTransparentBackground()
ScrollArea
ScrollArea implements smooth scrolling in the horizontal and vertical directions. The usage is exactly the same as QScrollArea.
ScrollArea
ScrollArea implements smooth scrolling in the horizontal and vertical directions. The usage is exactly the same as QScrollArea.
In some cases, smooth scrolling may cause the interface to stutter, and the method to cancel smooth scrolling is as follows:
scrollArea.setSmoothMode(SmoothMode.NO_SMOOTH)
SmoothScrollArea
SmoothScrollArea uses QPropertyAnimation to implement smooth scrolling in the horizontal and vertical directions. The usage is exactly the same as QScrollArea.
class Demo(SmoothScrollArea):
def __init__(self):
super().__init__()
# Load a high-resolution image
self.label = ImageLabel("path/to/image.png")
# Custom smooth scrolling animation
self.setScrollAnimation(Qt.Vertical, 400, QEasingCurve.OutQuint)
self.setScrollAnimation(Qt.Horizontal, 400, QEasingCurve.OutQuint)
# Scroll to a specific area
self.horizontalScrollBar().setValue(1900)
self.setWidget(self.label)
self.resize(1200, 800)