Класс QSplitterHandle

Класс QSplitterHandle предоставляет функциональность ручки для разделителя. Подробнее...

• Список всех членов, включая наследуемые

Открытые функции

Переопределённые открытые функции

Защищённые функции

Переопределённые защищённые функции

Подробное описание

QSplitterHandle — это то, что обычно представляют себе люди, когда думают о разделителе. Это ручка, используемая для изменения размера виджетов.

Обычному разработчику, использующему QSplitter, не нужно беспокоиться о QSplitterHandle. Он предоставляется разработчикам, которые хотят, чтобы ручки разделителя обеспечивали дополнительные функции, например, всплывающие меню.

Обычный способ создания ручек разделителя — это создание подкласса QSplitter, а затем переопределение QSplitter::createHandle() для создания пользовательской ручки разделителя. Например, минимальный подкласс QSplitter может выглядеть следующим образом:

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

protected:
    QSplitterHandle *createHandle() override;
};

Реализация createHandle() просто создаёт пользовательскую ручку разделителя, называемую Splitter в этом примере:

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

Информация о данной ручке может быть получена с помощью функций, таких как orientation() и opaqueResize(), и извлекается из родительского разделителя. Такие детали могут использоваться для придания пользовательским ручкам разного вида в зависимости от ориентации разделителя.

Сложность подкласса пользовательской ручки зависит от задач, которые он должен выполнять. Простой подкласс может предоставлять только реализацию paintEvent():

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 предоставляет разумный размер подсказки для ручки, поэтому подклассу не нужно предоставлять переопределение sizeHint(), если у ручки нет особых требований к размеру.

См. также QSplitter.

Документация по функциям-членам

QSplitterHandle::QSplitterHandle(Qt::Orientation orientation, QSplitter *parent)

Создаёт ручку QSplitter с заданной ориентацией и родительским объектом.

[virtual] QSplitterHandle::~QSplitterHandle()

Деструктор.

[protected] int QSplitterHandle::closestLegalPosition(int pos)

Возвращает ближайшую допустимую позицию к pos для ручки разделителя. Позиции измеряются от левого или верхнего края разделителя, даже для языков справа налево.

См. также QSplitter::closestLegalPosition() и moveSplitter().

[override virtual protected] bool QSplitterHandle::event(QEvent *event)

Переопределяет: QWidget::event(QEvent *event).

[override virtual protected] void QSplitterHandle::mouseMoveEvent(QMouseEvent *e)

Переопределяет: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QSplitterHandle::mousePressEvent(QMouseEvent *e)

Переопределяет: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QSplitterHandle::mouseReleaseEvent(QMouseEvent *e)

Переопределяет: QWidget::mouseReleaseEvent(QMouseEvent *event).

[protected] void QSplitterHandle::moveSplitter(int pos)

Указывает разделителю переместить эту ручку в позицию pos, которая представляет собой расстояние от левого или верхнего края виджета.

Обратите внимание, что pos также измеряется слева (или сверху) для языков справа налево. Эта функция будет сопоставлять pos с соответствующей позицией перед вызовом QSplitter::moveSplitter().

См. также QSplitter::moveSplitter() и closestLegalPosition().

bool QSplitterHandle::opaqueResize() const

Возвращает true если виджеты динамически (непрозрачно) изменяют размер во время интерактивного перемещения разделителя. В противном случае возвращает false. Это значение контролируется QSplitter.

См. также QSplitter::opaqueResize().

Qt::Orientation QSplitterHandle::orientation() const

Возвращает ориентацию ручки. Обычно она наследуется от QSplitter.

См. также setOrientation() и QSplitter::orientation().

[override virtual protected] void QSplitterHandle::paintEvent(QPaintEvent *)

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

[override virtual protected] void QSplitterHandle::resizeEvent(QResizeEvent *event)

Переопределяет: QWidget::resizeEvent(QResizeEvent *event).

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

Устанавливает ориентацию ручки разделителя на orientation. Обычно она наследуется от QSplitter.

См. также orientation() и QSplitter::setOrientation().

[override virtual] QSize QSplitterHandle::sizeHint() const

Переопределяет функцию доступа к свойству: QWidget::sizeHint.

QSplitter *QSplitterHandle::splitter() const

Возвращает разделитель, связанный с этим элементом управления разделителем.

См. также QSplitter::handle().