From 20af4254c248cab8ca1ae47e77d7c5e4ff2277d0 Mon Sep 17 00:00:00 2001 From: jules Date: Wed, 27 Aug 2014 20:16:40 +0100 Subject: [PATCH] Clarified some comments. --- modules/juce_gui_basics/components/juce_Component.h | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/modules/juce_gui_basics/components/juce_Component.h b/modules/juce_gui_basics/components/juce_Component.h index 629eac7495..edc1957a3e 100644 --- a/modules/juce_gui_basics/components/juce_Component.h +++ b/modules/juce_gui_basics/components/juce_Component.h @@ -1747,11 +1747,14 @@ public: */ virtual void focusLost (FocusChangeType cause); - /** Called to indicate that one of this component's children has been focused or unfocused. + /** Called to indicate a change in whether or not this component is the parent of the + currently-focused component. - Essentially this means that the return value of a call to hasKeyboardFocus (true) has + Essentially this is called when the return value of a call to hasKeyboardFocus (true) has changed. It happens when focus moves from one of this component's children (at any depth) to a component that isn't contained in this one, (or vice-versa). + Note that this method does NOT get called to when focus simply moves from one of its + child components to another. @see focusGained, setWantsKeyboardFocus, getCurrentlyFocusedComponent, hasKeyboardFocus */ @@ -1786,9 +1789,7 @@ public: bool isMouseButtonDown() const; /** True if the mouse is over this component, or if it's being dragged in this component. - This is a handy equivalent to (isMouseOver() || isMouseButtonDown()). - @see isMouseOver, isMouseButtonDown, isMouseButtonDownAnywhere */ bool isMouseOverOrDragging() const;