QSplitterHandle 类

class Splitter : public QSplitter
{
public:
    Splitter(Qt::Orientation orientation, QWidget *parent = nullptr);

protected:
    QSplitterHandle *createHandle() override;
};

QSplitterHandle *Splitter::createHandle()
{
    return new SplitterHandle(orientation(), this);
}

void SplitterHandle::paintEvent(QPaintEvent *event)
{
    QPainter painter(this);
    if (orientation() == Qt::Horizontal) {
        gradient.setStart(rect().left(), rect().height()/2);
        gradient.setFinalStop(rect().right(), rect().height()/2);
    } else {
        gradient.setStart(rect().width()/2, rect().top());
        gradient.setFinalStop(rect().width()/2, rect().bottom());
    }
    painter.fillRect(event->rect(), QBrush(gradient));
}

成员函数文档

[显式] QSplitterHandle::QSplitterHandle(Qt::Orientation orientation, QSplitter *parent)

创建一个具有指定 orientation 和 parent 的 QSplitter 句柄。

[虚函数，异常不抛出] QSplitterHandle::~QSplitterHandle()

析构函数。

[保护] int QSplitterHandle::closestLegalPosition(int pos)

返回分割器句柄最近的合法位置 pos。即使对于从右向左的语言，位置也是从分割器的左边缘或上边缘测量的。

另请参阅QSplitter::closestLegalPosition() 和 moveSplitter().

[重写，虚保护] bool QSplitterHandle::event(QEvent *event)

重新实现: QWidget::event(QEvent *event).

[重写，虚保护] void QSplitterHandle::mouseMoveEvent(QMouseEvent *e)

重新实现: QWidget::mouseMoveEvent(QMouseEvent *event).

[重写，虚保护] void QSplitterHandle::mousePressEvent(QMouseEvent *e)

重新实现: QWidget::mousePressEvent(QMouseEvent *event).

[重写，虚保护] void QSplitterHandle::mouseReleaseEvent(QMouseEvent *e)

重新实现: QWidget::mouseReleaseEvent(QMouseEvent *event).

[保护] void QSplitterHandle::moveSplitter(int pos)

告诉分割器将此句柄移动到位置 pos，这个位置是从小部件的左边缘或上边缘的距离。

注意，在从右向左的语言中，pos 也是从左（或上）测量的。这个函数将在调用QSplitter::moveSplitter()之前将 pos 映射到适当的位置。

参见QSplitter::moveSplitter() 和 closestLegalPosition()。

bool QSplitterHandle::opaqueResize() const

如果小部件在拖动分割器时动态（隐式）调整大小，则返回 true。否则返回 false。此值由 QSplitter 控制。

参见QSplitter::opaqueResize()。

Qt::Orientation QSplitterHandle::orientation() const

返回手柄的方向。这通常是从 QSplitter 传播出来的。

参见setOrientation() 和 QSplitter::orientation()。

[覆盖虚保护] void QSplitterHandle::paintEvent(QPaintEvent *)

重新实现了: QWidget::paintEvent(QPaintEvent *event)。

[覆盖虚保护] void QSplitterHandle::resizeEvent(QResizeEvent *event)

重新实现了: QWidget::resizeEvent(QResizeEvent *event)。

void QSplitterHandle::setOrientation(Qt::Orientation orientation)

将分割器手柄的方向设置为 orientation。这通常是从 QSplitter 传播出来的。

参见orientation() 和 QSplitter::setOrientation()。

[覆盖虚] QSize QSplitterHandle::sizeHint() const

重新实现了属性访问函数: QWidget::sizeHint。

QSplitter *QSplitterHandle::splitter() const

返回与该分割器手柄关联的分割器。

参见QSplitter::handle()。