QSplitterHandle Class
La clase QSplitterHandle proporciona la funcionalidad de controlador para el divisor. Más información...
| Encabezado: | #include <QSplitterHandle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan: | QWidget |
Funciones públicas
| QSplitterHandle(Qt::Orientation orientation, QSplitter *parent) | |
| virtual | ~QSplitterHandle() |
| bool | opaqueResize() const |
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation orientation) |
| QSplitter * | splitter() const |
Funciones públicas reimplementadas
| virtual QSize | sizeHint() const override |
Funciones protegidas
| int | closestLegalPosition(int pos) |
| void | moveSplitter(int pos) |
Funciones protegidas reimplementadas
| virtual bool | event(QEvent *event) override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | mousePressEvent(QMouseEvent *e) override |
| virtual void | mouseReleaseEvent(QMouseEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
| virtual void | resizeEvent(QResizeEvent *event) override |
Descripción detallada
QSplitterHandle es, por lo general, lo que viene a la mente cuando se piensa en un divisor. Es el controlador que se utiliza para cambiar el tamaño de los widgets.
Un desarrollador habitual que utilice QSplitter nunca tendrá que preocuparse por QSplitterHandle. Se proporciona para aquellos desarrolladores que deseen manejadores de divisor que ofrezcan características adicionales, como menús emergentes.
La forma habitual de crear controladores de divisor es crear una subclase de ` QSplitter ` y, a continuación, reimplementar ` QSplitter::createHandle()` para instanciar el controlador de divisor personalizado. Por ejemplo, una subclase mínima de ` QSplitter ` podría tener este aspecto:
class Splitter : public QSplitter
{
public:
Splitter(Qt::Orientation orientation, QWidget *parent = nullptr);
protected:
QSplitterHandle *createHandle() override;
};La implementación de ` createHandle()` simplemente construye un identificador de divisor personalizado, denominado ` Splitter ` en este ejemplo:
QSplitterHandle *Splitter::createHandle()
{
return new SplitterHandle(orientation(), this);
}Se puede obtener información sobre un identificador determinado mediante funciones como orientation() y opaqueResize(), y dicha información se recupera de su divisor principal. Detalles como estos pueden utilizarse para dar a los identificadores personalizados diferentes aspectos en función de la orientación del divisor.
La complejidad de una subclase de control personalizada depende de las tareas que deba realizar. Una subclase sencilla podría limitarse a proporcionar una implementación de 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));
}En este ejemplo, se configura un degradado predefinido de forma diferente según la orientación del controlador. QSplitterHandle proporciona una sugerencia de tamaño razonable para el controlador, por lo que la subclase no necesita reimplementar sizeHint() a menos que el controlador tenga requisitos especiales de tamaño.
Véase también QSplitter.
Documentación de las funciones miembro
[explicit] QSplitterHandle::QSplitterHandle(Qt::Orientation orientation, QSplitter *parent)
Crea un identificador de « QSplitter » con los valores indicados para « orientation » y « parent ».
[virtual noexcept] QSplitterHandle::~QSplitterHandle()
Destructor.
[protected] int QSplitterHandle::closestLegalPosition(int pos)
Devuelve la posición válida más cercana a pos del controlador del divisor. Las posiciones se miden desde el borde izquierdo o superior del divisor, incluso en el caso de los idiomas que se escriben de derecha a izquierda.
Véase también QSplitter::closestLegalPosition() y moveSplitter().
[override virtual protected] bool QSplitterHandle::event(QEvent *event)
Reimplementa: ` QWidget::event(QEvent *event)`.
[override virtual protected] void QSplitterHandle::mouseMoveEvent(QMouseEvent *e)
Reimplementa: QWidget::mouseMoveEvent(QMouseEvent *event).
[override virtual protected] void QSplitterHandle::mousePressEvent(QMouseEvent *e)
Reimplementa: QWidget::mousePressEvent(QMouseEvent *event).
[override virtual protected] void QSplitterHandle::mouseReleaseEvent(QMouseEvent *e)
Reimplementa: QWidget::mouseReleaseEvent(QMouseEvent *event).
[protected] void QSplitterHandle::moveSplitter(int pos)
Indica al divisor que mueva este controlador a la posición pos, que es la distancia desde el borde izquierdo o superior del widget.
Ten en cuenta que pos también se mide desde la izquierda (o desde arriba) en el caso de los idiomas que se escriben de derecha a izquierda. Esta función asignará pos a la posición adecuada antes de llamar a QSplitter::moveSplitter().
Véanse también QSplitter::moveSplitter() y closestLegalPosition().
bool QSplitterHandle::opaqueResize() const
Devuelve « true » si los widgets cambian de tamaño dinámicamente (de forma opaca) mientras se mueve interactivamente el separador. En caso contrario, devuelve « false ». Este valor viene determinado por la propiedad « QSplitter ».
Véase también QSplitter::opaqueResize().
Qt::Orientation QSplitterHandle::orientation() const
Devuelve la orientación del identificador. Por lo general, esta se hereda de QSplitter.
Véanse también setOrientation() y QSplitter::orientation().
[override virtual protected] void QSplitterHandle::paintEvent(QPaintEvent *)
Reimplementa: QWidget::paintEvent(QPaintEvent *event).
[override virtual protected] void QSplitterHandle::resizeEvent(QResizeEvent *event)
Reimplementa: ` QWidget::resizeEvent(QResizeEvent *event)`.
void QSplitterHandle::setOrientation(Qt::Orientation orientation)
Establece la orientación del controlador del divisor en « orientation ». Normalmente, este valor se hereda de « QSplitter ».
Véase también orientation() y QSplitter::setOrientation().
[override virtual] QSize QSplitterHandle::sizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::sizeHint.
QSplitter *QSplitterHandle::splitter() const
Devuelve el splitter asociado a este identificador de splitter.
Véase también QSplitter::handle().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.