1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. 2 // Use of this source code is governed by a BSD-style license that can be 3 // found in the LICENSE file. 4 // 5 // A helper class for animating the display of native widget content. 6 // Currently only handle vertical sliding, but could be extended to handle 7 // horizontal slides or other types of animations. 8 // 9 // NOTE: This does not handle clipping. If you are not careful, you will 10 // wind up with visibly overlapping widgets. If you need clipping, you can 11 // extend the constructor to take an option to give |fixed| its own GdkWindow 12 // (via gtk_fixed_set_has_window). 13 14 #ifndef CHROME_BROWSER_UI_GTK_SLIDE_ANIMATOR_GTK_H_ 15 #define CHROME_BROWSER_UI_GTK_SLIDE_ANIMATOR_GTK_H_ 16 #pragma once 17 18 #include <gtk/gtk.h> 19 20 #include "base/memory/scoped_ptr.h" 21 #include "chrome/browser/ui/gtk/owned_widget_gtk.h" 22 #include "ui/base/animation/animation_delegate.h" 23 24 namespace ui { 25 class SlideAnimation; 26 } 27 28 class SlideAnimatorGtk : public ui::AnimationDelegate { 29 public: 30 class Delegate { 31 public: 32 // Called when a call to Close() finishes animating. 33 virtual void Closed() = 0; 34 35 protected: 36 virtual ~Delegate() {} 37 }; 38 39 enum Direction { 40 DOWN, 41 UP 42 }; 43 44 // |child| is the widget we pack into |widget_|. 45 // |direction| indicates which side the contents will appear to come from. 46 // |duration| is the duration of the slide in milliseconds, or 0 for default. 47 // |linear| controls how the animation progresses. If true, the 48 // velocity of the slide is constant over time, otherwise it goes a bit faster 49 // at the beginning and slows to a halt. 50 // |delegate| may be NULL. 51 SlideAnimatorGtk(GtkWidget* child, 52 Direction direction, 53 int duration, 54 bool linear, 55 bool control_child_size, 56 Delegate* delegate); 57 58 virtual ~SlideAnimatorGtk(); 59 60 GtkWidget* widget() { return widget_.get(); } 61 62 // Slide open. 63 void Open(); 64 65 // Immediately show the widget. 66 void OpenWithoutAnimation(); 67 68 // Slide shut. 69 void Close(); 70 71 // End the current animation. 72 void End(); 73 74 // Immediately hide the widget. 75 void CloseWithoutAnimation(); 76 77 // Returns whether the widget is visible. 78 bool IsShowing(); 79 80 // Returns whether the widget is currently showing the close animation. 81 bool IsClosing(); 82 83 // Returns whether the widget is currently showing the open or close 84 // animation. 85 bool IsAnimating(); 86 87 // ui::AnimationDelegate implementation. 88 virtual void AnimationProgressed(const ui::Animation* animation); 89 virtual void AnimationEnded(const ui::Animation* animation); 90 91 // Used during testing; disable or enable animations (default is enabled). 92 static void SetAnimationsForTesting(bool enable); 93 94 private: 95 static void OnChildSizeAllocate(GtkWidget* child, 96 GtkAllocation* allocation, 97 SlideAnimatorGtk* slider); 98 99 scoped_ptr<ui::SlideAnimation> animation_; 100 101 // The top level widget of the SlideAnimatorGtk. It is a GtkFixed. 102 OwnedWidgetGtk widget_; 103 104 // The widget passed to us at construction time, and the only direct child of 105 // |widget_|. 106 GtkWidget* child_; 107 108 // The direction of the slide. 109 Direction direction_; 110 111 // The object to inform about certain events. It may be NULL. 112 Delegate* delegate_; 113 114 // We need to move the child widget to (0, -height), but we don't know its 115 // height until it has been allocated. This variable will be true until the 116 // child widget has been allocated, at which point we will move it, and then 117 // set this variable to false to indicate it should not be moved again. 118 bool child_needs_move_; 119 120 static bool animations_enabled_; 121 }; 122 123 #endif // CHROME_BROWSER_UI_GTK_SLIDE_ANIMATOR_GTK_H_ 124