From c0e04bad701211613269a5014c593c1d4d25a619 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Kundr=C3=A1t?= <jkt@flaska.net>
Date: Thu, 2 May 2013 01:07:27 +0200
Subject: [PATCH] doc: QWidget::setEnabled cannot enable children of a disabled
 widget
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The current documentation is not terribly clear on this topic, and there's a
couple of posts on various forums where people want to do this. In fact, the old
wording suggested (at least to me) that it is OK to explicitly override a
disabled state, which is apparently not true.

Change-Id: I10c54e0089e9ba5d16958aea62df27feafdf7b3d
Reviewed-by: Samuel RÃ¸dal <samuel.rodal@digia.com>
---
 src/widgets/kernel/qwidget.cpp | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/widgets/kernel/qwidget.cpp b/src/widgets/kernel/qwidget.cpp
index 0e868091fc2..cfccce7c418 100644
--- a/src/widgets/kernel/qwidget.cpp
+++ b/src/widgets/kernel/qwidget.cpp
@@ -3040,7 +3040,8 @@ QList<QAction*> QWidget::actions() const
 
     Disabling a widget implicitly disables all its children. Enabling
     respectively enables all child widgets unless they have been
-    explicitly disabled.
+    explicitly disabled. It it not possible to explicitly enable a child
+    widget which is not a window while its parent widget remains disabled.
 
     By default, this property is true.
 
-- 
GitLab