En esta página

QFocusFrame Class

El widget QFocusFrame proporciona un marco de enfoque que puede estar fuera del área normal pintable de un widget. Más...

Cabecera: #include <QFocusFrame>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QWidget

Funciones Públicas

QFocusFrame(QWidget *parent = nullptr)
virtual ~QFocusFrame()
void setWidget(QWidget *widget)
QWidget *widget() const

Funciones protegidas

virtual void initStyleOption(QStyleOption *option) const

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override
virtual bool eventFilter(QObject *o, QEvent *e) override
virtual void paintEvent(QPaintEvent *) override

Descripción Detallada

Normalmente una aplicación no necesitará crear su propio QFocusFrame ya que QStyle se encargará de este detalle por ti. Un escritor de estilos puede utilizar opcionalmente un QFocusFrame para tener un área de enfoque fuera de la geometría pintable del widget. De esta forma no es necesario reservar espacio para que el widget tenga foco sino que sólo se establece en un QWidget con QFocusFrame::setWidget. Es, sin embargo, legal crear tu propio QFocusFrame en un widget personalizado y establecer su geometría manualmente a través de QWidget::setGeometry sin embargo no obtendrás auto-colocación cuando el widget enfocado cambie de tamaño o colocación.

Documentación de las funciones miembro

QFocusFrame::QFocusFrame(QWidget *parent = nullptr)

Construye un QFocusFrame.

El marco de enfoque no monitorizará parent para actualizaciones sino que puede ser colocado manualmente o usando QFocusFrame::setWidget. Un QFocusFrame establece el atributo Qt::WA_NoChildEventsForParent; como resultado el padre no recibirá un evento QEvent::ChildAdded, esto hará posible establecer manualmente la geometría del QFocusFrame dentro de un QSplitter u otro widget de monitorización de eventos hijo.

Ver también QFocusFrame::setWidget().

[virtual noexcept] QFocusFrame::~QFocusFrame()

Destructor.

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

Reimplementa: QWidget::event(QEvent *event).

[override virtual protected] bool QFocusFrame::eventFilter(QObject *o, QEvent *e)

Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).

[virtual protected] void QFocusFrame::initStyleOption(QStyleOption *option) const

Inicializa option con los valores de este QFocusFrame. Este método es útil para subclases cuando necesitan un QStyleOption, pero no quieren rellenar toda la información ellos mismos.

Véase también QStyleOption::initFrom().

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

Reimplementa: QWidget::paintEvent(QPaintEvent *event).

void QFocusFrame::setWidget(QWidget *widget)

QFocusFrame seguirá los cambios en widget y cambiará su tamaño automáticamente. Si el padre del widget monitorizado cambia, QFocusFrame seguirá al widget y se colocará alrededor del widget automáticamente. Si el widget monitorizado es eliminado, QFocusFrame lo pondrá a cero.

Véase también QFocusFrame::widget().

QWidget *QFocusFrame::widget() const

Devuelve el widget actualmente monitorizado para redimensionarlo y actualizarlo automáticamente.

Véase también QFocusFrame::setWidget().

© 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.