[GTK] Add a couple comments to ScrollbarThemeGtk
authormcatanzaro@igalia.com <mcatanzaro@igalia.com@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Sun, 17 Jan 2016 00:00:43 +0000 (00:00 +0000)
committermcatanzaro@igalia.com <mcatanzaro@igalia.com@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Sun, 17 Jan 2016 00:00:43 +0000 (00:00 +0000)
https://bugs.webkit.org/show_bug.cgi?id=153184

Reviewed by Carlos Garcia Campos.

* platform/gtk/ScrollbarThemeGtk.cpp:
(WebCore::ScrollbarThemeGtk::paint):

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@195177 268f45cc-cd09-0410-ab3c-d52691b4dbfc

Source/WebCore/ChangeLog
Source/WebCore/platform/gtk/ScrollbarThemeGtk.cpp

index 2ef36d9..6a0b833 100644 (file)
@@ -1,3 +1,13 @@
+2016-01-16  Michael Catanzaro  <mcatanzaro@igalia.com>
+
+        [GTK] Add a couple comments to ScrollbarThemeGtk
+        https://bugs.webkit.org/show_bug.cgi?id=153184
+
+        Reviewed by Carlos Garcia Campos.
+
+        * platform/gtk/ScrollbarThemeGtk.cpp:
+        (WebCore::ScrollbarThemeGtk::paint):
+
 2016-01-16  Andreas Kling  <akling@apple.com>
 
         Give RuleSet a BumpArena and start using it for RuleDataVectors.
index 177e93e..3369762 100644 (file)
@@ -172,6 +172,9 @@ static inline const char* orientationStyleClass(ScrollbarOrientation orientation
     return orientation == VerticalScrollbar ? "vertical" : "horizontal";
 }
 
+// The GtkStyleContext returned by this function is cached by ScrollbarThemeGtk::paint for the
+// duration of its scope, so a different GtkStyleContext with updated theme properties will be
+// used for each call to paint.
 GRefPtr<GtkStyleContext> ScrollbarThemeGtk::getOrCreateStyleContext(ScrollbarOrientation orientation)
 {
     if (m_cachedStyleContext)
@@ -352,6 +355,7 @@ bool ScrollbarThemeGtk::paint(Scrollbar& scrollbar, GraphicsContext& graphicsCon
     if (graphicsContext.paintingDisabled())
         return false;
 
+    // Cache a new GtkStyleContext for the duration of this scope.
     TemporaryChange<GRefPtr<GtkStyleContext>> tempStyleContext(m_cachedStyleContext, getOrCreateStyleContext(scrollbar.orientation()));
 
     // Create the ScrollbarControlPartMask based on the damageRect