QFocusFrame Class

The QFocusFrame widget provides a focus frame which can be outside of a widget's normal paintable area. More...

Header: #include <QFocusFrame>
qmake: QT += widgets
Inherits: QWidget

Public Functions

QFocusFrame(QWidget *parent = Q_NULLPTR)
~QFocusFrame()
void setWidget(QWidget *widget)
QWidget *widget() const
  • 211 public functions inherited from QWidget
  • 31 public functions inherited from QObject
  • 14 public functions inherited from QPaintDevice

Protected Functions

void initStyleOption(QStyleOption *option) const

Reimplemented Protected Functions

virtual bool event(QEvent *e)
virtual bool eventFilter(QObject *o, QEvent *e)
virtual void paintEvent(QPaintEvent *)
  • 35 protected functions inherited from QWidget
  • 9 protected functions inherited from QObject
  • 1 protected function inherited from QPaintDevice

Additional Inherited Members

  • 58 properties inherited from QWidget
  • 1 property inherited from QObject
  • 19 public slots inherited from QWidget
  • 1 public slot inherited from QObject
  • 3 signals inherited from QWidget
  • 2 signals inherited from QObject
  • 1 public variable inherited from QObject
  • 5 static public members inherited from QWidget
  • 10 static public members inherited from QObject
  • 1 protected slot inherited from QWidget
  • 2 protected variables inherited from QObject
  • 1 protected type inherited from QPaintDevice

Detailed Description

The QFocusFrame widget provides a focus frame which can be outside of a widget's normal paintable area.

Normally an application will not need to create its own QFocusFrame as QStyle will handle this detail for you. A style writer can optionally use a QFocusFrame to have a focus area outside of the widget's paintable geometry. In this way space need not be reserved for the widget to have focus but only set on a QWidget with QFocusFrame::setWidget. It is, however, legal to create your own QFocusFrame on a custom widget and set its geometry manually via QWidget::setGeometry however you will not get auto-placement when the focused widget changes size or placement.

Member Function Documentation

QFocusFrame::QFocusFrame(QWidget *parent = Q_NULLPTR)

Constructs a QFocusFrame.

The focus frame will not monitor parent for updates but rather can be placed manually or by using QFocusFrame::setWidget. A QFocusFrame sets Qt::WA_NoChildEventsForParent attribute; as a result the parent will not receive a QEvent::ChildAdded event, this will make it possible to manually set the geometry of the QFocusFrame inside of a QSplitter or other child event monitoring widget.

See also QFocusFrame::setWidget().

QFocusFrame::~QFocusFrame()

Destructor.

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

Reimplemented from QObject::event().

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

Reimplemented from QObject::eventFilter().

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

Initialize option with the values from this QFocusFrame. This method is useful for subclasses when they need a QStyleOption, but don't want to fill in all the information themselves.

See also QStyleOption::initFrom().

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

Reimplemented from QWidget::paintEvent().

void QFocusFrame::setWidget(QWidget *widget)

QFocusFrame will track changes to widget and resize itself automatically. If the monitored widget's parent changes, QFocusFrame will follow the widget and place itself around the widget automatically. If the monitored widget is deleted, QFocusFrame will set it to zero.

See also QFocusFrame::widget().

QWidget *QFocusFrame::widget() const

Returns the currently monitored widget for automatically resize and update.

See also QFocusFrame::setWidget().