From f572b888994d0f5dee5bf4c12dfeb9edcce2f5dd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tor=20Arne=20Vestb=C3=B8?= Date: Thu, 14 Oct 2021 12:50:36 +0200 Subject: [PATCH] Clarify QWidget::normalGeometry documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The property reflects the widget's current geometry if it is not in a full screen or maximized state. Pick-to: 6.2 Change-Id: I5816687119500995654a926aef952d788ad74886 Reviewed-by: Volker Hilsheimer Reviewed-by: Tor Arne Vestbø --- src/widgets/kernel/qwidget.cpp | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) diff --git a/src/widgets/kernel/qwidget.cpp b/src/widgets/kernel/qwidget.cpp index d5a0e92fac5..0fe0029d67d 100644 --- a/src/widgets/kernel/qwidget.cpp +++ b/src/widgets/kernel/qwidget.cpp @@ -3583,19 +3583,6 @@ QPoint QWidget::pos() const resizeEvent(), minimumSize(), maximumSize() */ -/*! - \property QWidget::normalGeometry - - \brief the geometry of the widget as it will appear when shown as - a normal (not maximized or full screen) top-level widget - - For child widgets this property always holds an empty rectangle. - - By default, this property contains an empty rectangle. - - \sa QWidget::windowState(), QWidget::geometry -*/ - /*! \property QWidget::size \brief the size of the widget excluding any window frame @@ -3664,7 +3651,21 @@ QPoint QWidget::pos() const \sa size */ +/*! + \property QWidget::normalGeometry + \brief the geometry of the widget as it will appear when shown as + a normal (not maximized or full screen) top-level widget + + If the widget is already in this state the normal geometry will + reflect the widget's current geometry(). + + For child widgets this property always holds an empty rectangle. + + By default, this property contains an empty rectangle. + + \sa QWidget::windowState(), QWidget::geometry +*/ QRect QWidget::normalGeometry() const { Q_D(const QWidget);