QAbstractScrollArea Class
El widget QAbstractScrollArea ofrece un área de desplazamiento con barras de desplazamiento que aparecen cuando se necesitan. Más información...
| Encabezado: | #include <QAbstractScrollArea> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QFrame |
| Heredado por: | QAbstractItemView, QGraphicsView, QMdiArea, QPlainTextEdit, QScrollArea y QTextEdit |
Tipos públicos
| enum | SizeAdjustPolicy { AdjustIgnored, AdjustToContents, AdjustToContentsOnFirstShow } |
Propiedades
- horizontalScrollBarPolicy : Qt::ScrollBarPolicy
- sizeAdjustPolicy : SizeAdjustPolicy
- verticalScrollBarPolicy : Qt::ScrollBarPolicy
Funciones públicas
| QAbstractScrollArea(QWidget *parent = nullptr) | |
| virtual | ~QAbstractScrollArea() |
| void | addScrollBarWidget(QWidget *widget, Qt::Alignment alignment) |
| QWidget * | cornerWidget() const |
| QScrollBar * | horizontalScrollBar() const |
| Qt::ScrollBarPolicy | horizontalScrollBarPolicy() const |
| QSize | maximumViewportSize() const |
| QWidgetList | scrollBarWidgets(Qt::Alignment alignment) |
| void | setCornerWidget(QWidget *widget) |
| void | setHorizontalScrollBar(QScrollBar *scrollBar) |
| void | setHorizontalScrollBarPolicy(Qt::ScrollBarPolicy) |
| void | setSizeAdjustPolicy(QAbstractScrollArea::SizeAdjustPolicy policy) |
| void | setVerticalScrollBar(QScrollBar *scrollBar) |
| void | setVerticalScrollBarPolicy(Qt::ScrollBarPolicy) |
| void | setViewport(QWidget *widget) |
| virtual void | setupViewport(QWidget *viewport) |
| QAbstractScrollArea::SizeAdjustPolicy | sizeAdjustPolicy() const |
| QScrollBar * | verticalScrollBar() const |
| Qt::ScrollBarPolicy | verticalScrollBarPolicy() const |
| QWidget * | viewport() const |
Funciones públicas reimplementadas
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Funciones protegidas
| virtual void | scrollContentsBy(int dx, int dy) |
| void | setViewportMargins(const QMargins &margins) |
| void | setViewportMargins(int left, int top, int right, int bottom) |
| virtual bool | viewportEvent(QEvent *event) |
| QMargins | viewportMargins() const |
| virtual QSize | viewportSizeHint() const |
Funciones protegidas reimplementadas
| virtual void | contextMenuEvent(QContextMenuEvent *e) override |
| virtual void | dragEnterEvent(QDragEnterEvent *event) override |
| virtual void | dragLeaveEvent(QDragLeaveEvent *event) override |
| virtual void | dragMoveEvent(QDragMoveEvent *event) override |
| virtual void | dropEvent(QDropEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual void | keyPressEvent(QKeyEvent *e) override |
| virtual void | mouseDoubleClickEvent(QMouseEvent *e) override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | mousePressEvent(QMouseEvent *e) override |
| virtual void | mouseReleaseEvent(QMouseEvent *e) override |
| virtual void | paintEvent(QPaintEvent *event) override |
| virtual void | resizeEvent(QResizeEvent *event) override |
| virtual void | wheelEvent(QWheelEvent *e) override |
Descripción detallada
QAbstractScrollArea es una abstracción de bajo nivel de un área de desplazamiento. El área proporciona un widget central denominado «ventana de visualización», en el que se desplaza el contenido del área (es decir, las partes visibles del contenido se representan en la ventana de visualización).
Junto a la ventana de visualización hay una barra de desplazamiento vertical y, debajo, una barra de desplazamiento horizontal. Cuando todo el contenido del área cabe en la ventana de visualización, cada barra de desplazamiento puede estar visible u oculta, dependiendo de su propiedad ` Qt::ScrollBarPolicy`. Cuando una barra de desplazamiento está oculta, la ventana de visualización se expande para cubrir todo el espacio disponible. Cuando una barra de desplazamiento vuelve a estar visible, la ventana de visualización se reduce para dejar espacio a la barra de desplazamiento.
Es posible reservar un área de margen alrededor de la ventana de visualización; véase setViewportMargins(). Esta característica se utiliza principalmente para colocar un widget QHeaderView encima o al lado del área de desplazamiento. Las subclases de QAbstractScrollArea deben implementar los márgenes.
Al heredar de `QAbstractScrollArea`, debe hacer lo siguiente:
- Controlar las barras de desplazamiento estableciendo su rango, valor y paso de página, y realizando un seguimiento de sus movimientos.
- Dibujar el contenido del área en la ventana de visualización según los valores de las barras de desplazamiento.
- Gestionar los eventos recibidos por la ventana de visualización en ` viewportEvent()` —en particular, los eventos de cambio de tamaño—.
- Utilizar `
viewport->update()` para actualizar el contenido de la ventana de visualización en lugar de ` update()``, ya que todas las operaciones de dibujo tienen lugar en la ventana de visualización.
Con una política de barras de desplazamiento de tipo « Qt::ScrollBarAsNeeded » (por defecto), QAbstractScrollArea muestra las barras de desplazamiento cuando ofrecen un rango de desplazamiento distinto de cero y, en caso contrario, las oculta.
Las barras de desplazamiento y la ventana gráfica deben actualizarse cada vez que la ventana gráfica reciba un evento de redimensionamiento o cambie el tamaño del contenido. La ventana gráfica también debe actualizarse cuando cambien los valores de las barras de desplazamiento. Los valores iniciales de las barras de desplazamiento suelen establecerse cuando el área recibe nuevo contenido.
A continuación ofrecemos un ejemplo sencillo, en el que hemos implementado un área de desplazamiento capaz de desplazar cualquier QWidget. Hacemos que el widget sea un elemento secundario de la ventana de visualización; de esta forma, no tenemos que calcular qué parte del widget hay que dibujar, sino que simplemente podemos mover el widget con QWidget::move(). Cuando cambia el contenido del área o el tamaño de la ventana de visualización, hacemos lo siguiente:
QSize areaSize = viewport()->size();
QSize widgetSize = widget->size();
verticalScrollBar()->setPageStep(areaSize.height());
horizontalScrollBar()->setPageStep(areaSize.width());
verticalScrollBar()->setRange(0, widgetSize.height() - areaSize.height());
horizontalScrollBar()->setRange(0, widgetSize.width() - areaSize.width());
updateWidgetPosition();Cuando las barras de desplazamiento cambian de valor, debemos actualizar la posición del widget, es decir, encontrar la parte del widget que debe dibujarse en la ventana gráfica:
int hvalue = horizontalScrollBar()->value();
int vvalue = verticalScrollBar()->value();
QPoint topLeft = viewport()->rect().topLeft();
widget->move(topLeft.x() - hvalue, topLeft.y() - vvalue);Para realizar un seguimiento de los movimientos de las barras de desplazamiento, reimplementa la función virtual ` scrollContentsBy()`. Para ajustar con precisión el comportamiento del desplazamiento, conéctate a la señal ` QAbstractSlider::actionTriggered()` de una barra de desplazamiento y modifica ` QAbstractSlider::sliderPosition ` según desees.
Para mayor comodidad, QAbstractScrollArea pone a disposición todos los eventos del área de visualización en el controlador virtual viewportEvent(). Los controladores especializados de QWidget se reasignan a eventos del área de visualización en los casos en que resulte conveniente. Los controladores especializados reasignados son: paintEvent(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), wheelEvent(), dragEnterEvent(), dragMoveEvent(), dragLeaveEvent(), dropEvent(), contextMenuEvent() y resizeEvent().
QScrollArea, que hereda de QAbstractScrollArea, proporciona un desplazamiento fluido para cualquier QWidget (es decir, el widget se desplaza píxel a píxel). Solo es necesario crear una subclase de `QAbstractScrollArea` si se necesita un comportamiento más especializado. Esto ocurre, por ejemplo, si el contenido completo del área no es adecuado para ser dibujado en un ` QWidget ` o si no se desea un desplazamiento suave.
Véase también QScrollArea.
Documentación sobre los tipos de miembros
enum QAbstractScrollArea::SizeAdjustPolicy
Esta enumeración especifica cómo debe ajustarse la indicación de tamaño del « QAbstractScrollArea » cuando cambia el tamaño de la ventana gráfica.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractScrollArea::AdjustIgnored | 0 | El área de desplazamiento se comportará como hasta ahora, sin realizar ningún ajuste. |
QAbstractScrollArea::AdjustToContents | 2 | El área de desplazamiento se ajustará siempre al área de visualización |
QAbstractScrollArea::AdjustToContentsOnFirstShow | 1 | El área de desplazamiento se ajustará a su ventana gráfica la primera vez que se muestre. |
Documentación de la propiedad
horizontalScrollBarPolicy : Qt::ScrollBarPolicy
Esta propiedad define la política de la barra de desplazamiento horizontal
La política predeterminada es « Qt::ScrollBarAsNeeded ».
Funciones de Access:
| Qt::ScrollBarPolicy | horizontalScrollBarPolicy() const |
| void | setHorizontalScrollBarPolicy(Qt::ScrollBarPolicy) |
Véase también verticalScrollBarPolicy.
sizeAdjustPolicy : SizeAdjustPolicy
Esta propiedad contiene la política que describe cómo cambia el tamaño del área de desplazamiento cuando cambia el tamaño de la ventana gráfica.
La política predeterminada es « QAbstractScrollArea::AdjustIgnored ». Al modificar esta propiedad, es posible que se redimensione el área de desplazamiento.
Funciones de acceso:
| QAbstractScrollArea::SizeAdjustPolicy | sizeAdjustPolicy() const |
| void | setSizeAdjustPolicy(QAbstractScrollArea::SizeAdjustPolicy policy) |
verticalScrollBarPolicy : Qt::ScrollBarPolicy
Esta propiedad define la política de la barra de desplazamiento vertical
La política predeterminada es « Qt::ScrollBarAsNeeded ».
Funciones de Access:
| Qt::ScrollBarPolicy | verticalScrollBarPolicy() const |
| void | setVerticalScrollBarPolicy(Qt::ScrollBarPolicy) |
Véase también horizontalScrollBarPolicy.
Documentación de las funciones de miembro
[explicit] QAbstractScrollArea::QAbstractScrollArea(QWidget *parent = nullptr)
Crea una ventana gráfica.
El argumento « parent » se envía al constructor « QWidget ».
[virtual noexcept] QAbstractScrollArea::~QAbstractScrollArea()
Elimina la ventana gráfica.
void QAbstractScrollArea::addScrollBarWidget(QWidget *widget, Qt::Alignment alignment)
Añade « widget » como widget de barra de desplazamiento en la ubicación especificada por « alignment ».
Los widgets de barra de desplazamiento se muestran junto a la barra de desplazamiento horizontal o vertical, y pueden colocarse a cualquiera de sus lados. Si deseas que los widgets de barra de desplazamiento estén siempre visibles, establece la propiedad scrollBarPolicy de la barra de desplazamiento correspondiente en AlwaysOn.
alignment Debe ser uno de los siguientes valores: Qt::Alignleft y Qt::AlignRight, que se asocian a la barra de desplazamiento horizontal, o Qt::AlignTop y Qt::AlignBottom, que se asocian a la barra de desplazamiento vertical.
Un widget de barra de desplazamiento puede eliminarse bien cambiando su padre, bien borrándolo. También es posible ocultar un widget con QWidget::hide()
El widget de barra de desplazamiento se redimensionará para adaptarse a la geometría de la barra de desplazamiento del estilo actual. A continuación se describe el caso de los widgets de barra de desplazamiento en la barra de desplazamiento horizontal:
La altura del widget se ajustará para que coincida con la altura de la barra de desplazamiento. Para controlar la anchura del widget, utiliza QWidget::setMinimumWidth y QWidget::setMaximumWidth, o implementa QWidget::sizeHint() y establece una política de tamaño horizontal. Si deseas un widget cuadrado, llama a QStyle::pixelMetric(QStyle::PM_ScrollBarExtent) y establece la anchura en este valor.
Véase también scrollBarWidgets().
[override virtual protected] void QAbstractScrollArea::contextMenuEvent(QContextMenuEvent *e)
Reimplementa: ` QWidget::contextMenuEvent` (`QContextMenuEvent *event`).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos del menú contextual del widget ` viewport()`. El evento se pasa a ` e`.
Véase también QWidget::contextMenuEvent().
QWidget *QAbstractScrollArea::cornerWidget() const
Devuelve el widget situado en la esquina entre las dos barras de desplazamiento.
Por defecto, no hay ningún widget de esquina.
Véase también setCornerWidget().
[override virtual protected] void QAbstractScrollArea::dragEnterEvent(QDragEnterEvent *event)
Reimplementa: QWidget::dragEnterEvent(QDragEnterEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de inicio de arrastre (pasados en event), para el widget viewport().
Véase también QWidget::dragEnterEvent().
[override virtual protected] void QAbstractScrollArea::dragLeaveEvent(QDragLeaveEvent *event)
Reimplementa: QWidget::dragLeaveEvent(QDragLeaveEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de salida de arrastre (pasados en ` event`), para el widget ` viewport()`.
Véase también QWidget::dragLeaveEvent().
[override virtual protected] void QAbstractScrollArea::dragMoveEvent(QDragMoveEvent *event)
Reimplementa: QWidget::dragMoveEvent(QDragMoveEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de arrastre y desplazamiento (pasados a través de ` event`), para el widget ` viewport()`.
Véase también QWidget::dragMoveEvent().
[override virtual protected] void QAbstractScrollArea::dropEvent(QDropEvent *event)
Reimplementa: QWidget::dropEvent(QDropEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de soltar (pasados en ` event`), para el widget ` viewport()`.
Véase también QWidget::dropEvent().
[override virtual protected] bool QAbstractScrollArea::event(QEvent *event)
Reimplementa: QFrame::event(QEvent *e).
Este es el controlador de eventos principal del widget QAbstractScrollArea (no el del área de desplazamiento viewport()). El objeto event especificado es un objeto de evento genérico que puede ser necesario convertir a la clase adecuada en función de su tipo.
Véase también QEvent::type().
QScrollBar *QAbstractScrollArea::horizontalScrollBar() const
Devuelve la barra de desplazamiento horizontal.
Véase también setHorizontalScrollBar(), horizontalScrollBarPolicy y verticalScrollBar().
[override virtual protected] void QAbstractScrollArea::keyPressEvent(QKeyEvent *e)
Reimplementa: QWidget::keyPressEvent(QKeyEvent *event).
Esta función se invoca con el evento de tecla e cuando se pulsan las teclas. Gestiona las teclas AvPág, RePág, Arriba, Abajo, Izquierda y Derecha, e ignora todas las demás pulsaciones de teclas.
QSize QAbstractScrollArea::maximumViewportSize() const
Devuelve el tamaño de la ventana de visualización como si las barras de desplazamiento no tuvieran ningún rango de desplazamiento válido.
[override virtual] QSize QAbstractScrollArea::minimumSizeHint() const
Reimplementa una función de acceso para la propiedad: QWidget::minimumSizeHint.
[override virtual protected] void QAbstractScrollArea::mouseDoubleClickEvent(QMouseEvent *e)
Reimplementa: QWidget::mouseDoubleClickEvent(QMouseEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de doble clic del ratón para el widget viewport(). El evento se pasa a e.
Véase también QWidget::mouseDoubleClickEvent().
[override virtual protected] void QAbstractScrollArea::mouseMoveEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mouseMoveEvent(QMouseEvent *event)`.
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de movimiento del ratón para el widget viewport(). El evento se pasa en e.
Véase también QWidget::mouseMoveEvent().
[override virtual protected] void QAbstractScrollArea::mousePressEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mousePressEvent(QMouseEvent *event)`.
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de pulsación del ratón para el widget viewport(). El evento se pasa a e.
La implementación predeterminada llama a QWidget::mousePressEvent() para gestionar el menú emergente de forma predeterminada.
Véase también ` QWidget::mousePressEvent()`.
[override virtual protected] void QAbstractScrollArea::mouseReleaseEvent(QMouseEvent *e)
Reimplementa: ` QWidget::mouseReleaseEvent(QMouseEvent *event)`.
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de liberación del ratón para el widget ` viewport()`. El evento se pasa en ` e`.
Véase también QWidget::mouseReleaseEvent().
[override virtual protected] void QAbstractScrollArea::paintEvent(QPaintEvent *event)
Reimplementa: QFrame::paintEvent(QPaintEvent *).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de dibujo (pasados en ` event`), para el widget ` viewport()`.
Véase también ` QWidget::paintEvent()`.
[override virtual protected] void QAbstractScrollArea::resizeEvent(QResizeEvent *event)
Reimplementa: QWidget::resizeEvent(QResizeEvent *event).
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de cambio de tamaño (pasados en event), para el widget viewport().
Cuando se llama a resizeEvent(), la ventana gráfica ya tiene su nueva geometría: se puede acceder a su nuevo tamaño a través de la función QResizeEvent::size(), y al tamaño anterior a través de QResizeEvent::oldSize().
Véase también QWidget::resizeEvent().
QWidgetList QAbstractScrollArea::scrollBarWidgets(Qt::Alignment alignment)
Devuelve una lista de los controles de barra de desplazamiento configurados actualmente. « alignment » puede ser cualquier combinación de los cuatro indicadores de ubicación.
Véase también addScrollBarWidget().
[virtual protected] void QAbstractScrollArea::scrollContentsBy(int dx, int dy)
Este controlador virtual se activa cuando se mueven las barras de desplazamiento mediante ` dx` y ` dy`, por lo que el contenido de la ventana gráfica debe desplazarse en consecuencia.
La implementación por defecto simplemente llama a ` update()` sobre todo el ` viewport()`. Las subclases pueden reimplementar este controlador con fines de optimización o —como en ` QScrollArea `— para desplazar un widget de contenido. Los parámetros ` dx ` y ` dy ` están ahí por comodidad, para que la clase sepa cuánto se debe desplazar (útil, por ejemplo, al realizar desplazamientos de píxeles). También puedes ignorar estos valores y desplazarte directamente a la posición que indican las barras de desplazamiento.
Llamar a esta función para desplazar el contenido mediante código es un error; utiliza en su lugar las barras de desplazamiento (por ejemplo, llamando directamente a QScrollBar::setValue()).
void QAbstractScrollArea::setCornerWidget(QWidget *widget)
Establece el widget situado en la esquina entre las dos barras de desplazamiento en « widget ».
Probablemente también querrás configurar al menos uno de los modos de barra de desplazamiento como « AlwaysOn ».
Si se pasa « nullptr », no se muestra ningún widget en la esquina.
Cualquier widget de esquina anterior queda oculto.
Puedes llamar a `setCornerWidget()` con el mismo widget en diferentes momentos.
Todos los widgets establecidos aquí serán eliminados por el área de desplazamiento cuando esta se destruya, a menos que se vuelva a asignar un padre al widget por separado tras establecer algún otro widget de esquina (o « nullptr »).
Cualquier widget recién establecido no debe tener ningún padre actual.
Por defecto, no hay ningún widget de esquina presente.
Véase también cornerWidget() y horizontalScrollBarPolicy.
void QAbstractScrollArea::setHorizontalScrollBar(QScrollBar *scrollBar)
Sustituye la barra de desplazamiento horizontal existente por scrollBar y asigna todas las propiedades del control deslizante de la barra anterior a la nueva barra de desplazamiento. A continuación, se elimina la barra de desplazamiento anterior.
QAbstractScrollArea Ya proporciona barras de desplazamiento horizontales y verticales de forma predeterminada. Puedes llamar a esta función para sustituir la barra de desplazamiento horizontal predeterminada por tu propia barra de desplazamiento personalizada.
Véase también horizontalScrollBar() y setVerticalScrollBar().
void QAbstractScrollArea::setVerticalScrollBar(QScrollBar *scrollBar)
Sustituye la barra de desplazamiento vertical existente por scrollBar y asigna todas las propiedades del control deslizante de la barra anterior a la nueva barra de desplazamiento. A continuación, se elimina la barra de desplazamiento anterior.
QAbstractScrollArea Ya proporciona barras de desplazamiento verticales y horizontales de forma predeterminada. Puedes llamar a esta función para sustituir la barra de desplazamiento vertical predeterminada por tu propia barra de desplazamiento personalizada.
Véase también verticalScrollBar() y setHorizontalScrollBar().
void QAbstractScrollArea::setViewport(QWidget *widget)
Establece la ventana gráfica en el elemento « widget » indicado. El elemento « QAbstractScrollArea » asumirá la propiedad del elemento « widget » indicado.
Si widget es nullptr, QAbstractScrollArea asignará una nueva instancia de QWidget a la ventana gráfica.
Véase también viewport().
[protected] void QAbstractScrollArea::setViewportMargins(const QMargins &margins)
Establece un valor de ` margins ` alrededor del área de desplazamiento. Esto resulta útil para aplicaciones como hojas de cálculo con filas y columnas «bloqueadas». El espacio marginal se deja en blanco; coloca los widgets en el área no utilizada.
Por defecto, todos los márgenes son cero.
Véase también viewportMargins().
[protected] void QAbstractScrollArea::setViewportMargins(int left, int top, int right, int bottom)
Establece los márgenes alrededor del área de desplazamiento en left, top, right y bottom. Esto resulta útil para aplicaciones como hojas de cálculo con filas y columnas «bloqueadas». El espacio marginal se deja en blanco; coloca los widgets en el área no utilizada.
Tenga en cuenta que esta función es llamada con frecuencia por QTreeView y QTableView, por lo que los márgenes deben ser implementados por las subclases de QAbstractScrollArea. Además, si las subclases se van a utilizar en vistas de elementos, no deben llamar a esta función.
Por defecto, todos los márgenes son cero.
Véase también viewportMargins().
[virtual] void QAbstractScrollArea::setupViewport(QWidget *viewport)
Este método es invocado por QAbstractScrollArea después de que se haya invocado setViewport(viewport). Reimplementa esta función en una subclase de QAbstractScrollArea para inicializar el nuevo viewport antes de que se utilice.
Véase también setViewport().
[override virtual] QSize QAbstractScrollArea::sizeHint() const
Reimplementa: ` QFrame::sizeHint()` const.
Devuelve la propiedad `sizeHint` del área de desplazamiento. El tamaño se determina utilizando ` viewportSizeHint()` más algo de espacio adicional para las barras de desplazamiento, si es necesario.
QScrollBar *QAbstractScrollArea::verticalScrollBar() const
Devuelve la barra de desplazamiento vertical.
Véase también setVerticalScrollBar(), verticalScrollBarPolicy y horizontalScrollBar().
QWidget *QAbstractScrollArea::viewport() const
Devuelve el widget de la ventana gráfica.
Utiliza la función ` QScrollArea::widget()` para recuperar el contenido del widget de la ventana gráfica.
Véase también setViewport() y QScrollArea::widget().
[virtual protected] bool QAbstractScrollArea::viewportEvent(QEvent *event)
El controlador de eventos principal para el área de desplazamiento (el widget ` viewport()`). Gestiona el ` event ` especificado y puede ser invocado por las subclases para proporcionar un comportamiento predeterminado adecuado.
Devuelve true para indicar al sistema de eventos que el evento ha sido gestionado y no requiere más procesamiento; en caso contrario, devuelve false para indicar que el evento debe propagarse más allá.
Se puede reimplementar esta función en una subclase, pero recomendamos utilizar en su lugar uno de los controladores de eventos especializados.
Los controladores especializados para eventos de la ventana gráfica son: paintEvent(), mousePressEvent(), mouseReleaseEvent(), mouseDoubleClickEvent(), mouseMoveEvent(), wheelEvent(), dragEnterEvent(), dragMoveEvent(), dragLeaveEvent(), dropEvent(), contextMenuEvent() y resizeEvent().
[protected] QMargins QAbstractScrollArea::viewportMargins() const
Devuelve los márgenes que rodean el área de desplazamiento. Por defecto, todos los márgenes son cero.
Véase también setViewportMargins().
[virtual protected] QSize QAbstractScrollArea::viewportSizeHint() const
Devuelve el tamaño recomendado para la ventana de visualización. La implementación predeterminada devuelve viewport()->sizeHint(). Ten en cuenta que el tamaño corresponde únicamente a la ventana de visualización, sin que se vean las barras de desplazamiento.
[override virtual protected] void QAbstractScrollArea::wheelEvent(QWheelEvent *e)
Reimplementa: ` QWidget::wheelEvent(QWheelEvent *event)`.
Este controlador de eventos se puede reimplementar en una subclase para recibir eventos de rueda para el widget viewport(). El evento se pasa en e.
Véase también QWidget::wheelEvent().
© 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.