Make theme change notifications auto-propagate through the view hierarchy, in...

views/view.h

 // Copyright (c) 2010 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef VIEWS_VIEW_H_
 #define VIEWS_VIEW_H_
 
 #include "build/build_config.h"
 
 #include <algorithm>
@@ skipping 957 matching lines @@
 
  protected:
   // Returns whether this view can accept focus.
   // A view can accept focus if it's enabled, focusable and visible.
   // This method is intended for views to use when calculating preferred size.
   // The FocusManager and other places use IsFocusableInRootView.
   virtual bool IsFocusable() const;
 
   // Called when the UI theme has changed, overriding allows individual Views to
   // do special cleanup and processing (such as dropping resource caches).
-  // Subclasses that override this method must call the base class
-  // implementation to ensure child views are processed.
-  // Can only be called by subclasses. To dispatch a theme changed notification,
-  // call this method on the RootView.
-  virtual void ThemeChanged();
+  // To dispatch a theme changed notification, call
+  // RootView::NotifyThemeChanged().
+  virtual void OnThemeChanged() { }
 
   // Called when the locale has changed, overriding allows individual Views to
   // update locale-dependent strings.
-  virtual void LocaleChanged() { }
+  // To dispatch a locale changed notification, call
+  // RootView::NotifyLocaleChanged().
+  virtual void OnLocaleChanged() { }
 
 #ifndef NDEBUG
   // Returns true if the View is currently processing a paint.
   virtual bool IsProcessingPaint() const;
 #endif
 
   // Returns the location, in screen coordinates, to show the context menu at
   // when the context menu is shown from the keyboard. This implementation
   // returns the middle of the visible region of this view.
   //
@@ skipping 133 matching lines @@
     // a drag.
     void PossibleDrag(const gfx::Point& p);
 
     // Whether the press may generate a drag.
     bool possible_drag;
 
     // Coordinates of the mouse press.
     gfx::Point start_pt;
   };
 
-  // Propagates locale changed notification from the root view downside.
-  // Invokes LocaleChanged() for every view in the hierarchy.
-  virtual void NotifyLocaleChanged();
+  // Used to propagate theme changed notifications from the root view to all
+  // views in the hierarchy.
+  virtual void PropagateThemeChanged();
+
+  // Used to propagate locale changed notifications from the root view to all
+  // views in the hierarchy.
+  virtual void PropagateLocaleChanged();
 
   // RootView invokes these. These in turn invoke the appropriate OnMouseXXX
   // method. If a drag is detected, DoDrag is invoked.
   bool ProcessMousePressed(const MouseEvent& e, DragInfo* drop_info);
   bool ProcessMouseDragged(const MouseEvent& e, DragInfo* drop_info);
   void ProcessMouseReleased(const MouseEvent& e, bool canceled);
 
   // Starts a drag and drop operation originating from this view. This invokes
   // WriteDragData to write the data and GetDragOperations to determine the
   // supported drag operations. When done, OnDragDone is invoked.
@@ skipping 162 matching lines @@
   // The default value for how long to wait (in ms) before showing a menu
   // button on hover. This value is used if the OS doesn't supply one.
   static const int kShowFolderDropMenuDelay;
 
   DISALLOW_COPY_AND_ASSIGN(View);
 };
 
 }  // namespace views
 
 #endif  // VIEWS_VIEW_H_