Contents

• Public Functions
• Protected Functions
• Reimplemented Protected Functions
• Detailed Description

Detailed Description

TheQFocusFrame 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 ownQFocusFrame asQStyle will handle this detail for you. A style writer can optionally use aQFocusFrame 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 aQWidget withQFocusFrame::setWidget. It is, however, legal to create your ownQFocusFrame on a custom widget and set its geometry manually viaQWidget::setGeometry however you will not get auto-placement when the focused widget changes size or placement.

Member Function Documentation

QFocusFrame::QFocusFrame(QWidget * parent = 0)

Constructs aQFocusFrame.

The focus frame will not monitorparent for updates but rather can be placed manually or by usingQFocusFrame::setWidget. AQFocusFrame setsQt::WA_NoChildEventsForParent attribute; as a result the parent will not receive aQEvent::ChildInserted event, this will make it possible to manually set the geometry of theQFocusFrame inside of aQSplitter or other child event monitoring widget.

See alsoQFocusFrame::setWidget().

QFocusFrame::~QFocusFrame()

Destructor.

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

Reimplemented fromQObject::event().

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

Reimplemented fromQObject::eventFilter().

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

Initializeoption with the values from thisQFocusFrame. This method is useful for subclasses when they need aQStyleOption, but don't want to fill in all the information themselves.

See alsoQStyleOption::initFrom().

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

Reimplemented fromQWidget::paintEvent().

void QFocusFrame::setWidget(QWidget * widget)

QFocusFrame will track changes towidget 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 alsoQFocusFrame::widget().

QWidget * QFocusFrame::widget() const

Returns the currently monitored widget for automatically resize and update.

See alsoQFocusFrame::setWidget().