diff options
Diffstat (limited to 'chromium/ui/app_list/views/apps_grid_view.h')
| -rw-r--r-- | chromium/ui/app_list/views/apps_grid_view.h | 421 |
1 files changed, 0 insertions, 421 deletions
diff --git a/chromium/ui/app_list/views/apps_grid_view.h b/chromium/ui/app_list/views/apps_grid_view.h deleted file mode 100644 index 043f6facb38..00000000000 --- a/chromium/ui/app_list/views/apps_grid_view.h +++ /dev/null @@ -1,421 +0,0 @@ -// Copyright (c) 2012 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 UI_APP_LIST_VIEWS_APPS_GRID_VIEW_H_ -#define UI_APP_LIST_VIEWS_APPS_GRID_VIEW_H_ - -#include <set> - -#include "base/basictypes.h" -#include "base/compiler_specific.h" -#include "base/timer/timer.h" -#include "ui/app_list/app_list_export.h" -#include "ui/app_list/app_list_model.h" -#include "ui/app_list/app_list_model_observer.h" -#include "ui/app_list/pagination_model_observer.h" -#include "ui/base/models/list_model_observer.h" -#include "ui/views/animation/bounds_animator.h" -#include "ui/views/controls/button/button.h" -#include "ui/views/view.h" -#include "ui/views/view_model.h" - -#if defined(OS_WIN) -#include "ui/base/dragdrop/drag_source_win.h" -#endif - -namespace content { -class WebContents; -} - -namespace views { -class ButtonListener; -class DragImageView; -class WebView; -} - -namespace app_list { - -#if defined(OS_WIN) -class SynchronousDrag; -#endif - -namespace test { -class AppsGridViewTestApi; -} - -class ApplicationDragAndDropHost; -class AppListItemView; -class AppsGridViewDelegate; -class PageSwitcher; -class PaginationModel; - -// AppsGridView displays a grid for AppListItemList sub model. -class APP_LIST_EXPORT AppsGridView : public views::View, - public views::ButtonListener, - public AppListItemListObserver, - public PaginationModelObserver, - public AppListModelObserver { - public: - enum Pointer { - NONE, - MOUSE, - TOUCH, - }; - - // Constructs the app icon grid view. |delegate| is the delegate of this - // view, which usually is the hosting AppListView. |pagination_model| is - // the paging info shared within the launcher UI. |start_page_contents| is - // the contents for the launcher start page. It could be NULL if the start - // page is not available. - AppsGridView(AppsGridViewDelegate* delegate, - PaginationModel* pagination_model, - content::WebContents* start_page_contents); - virtual ~AppsGridView(); - - // Sets fixed layout parameters. After setting this, CalculateLayout below - // is no longer called to dynamically choosing those layout params. - void SetLayout(int icon_size, int cols, int rows_per_page); - - // Sets |model| to use. Note this does not take ownership of |model|. - void SetModel(AppListModel* model); - - // Sets the |item_list| to render. Note this does not take ownership of - // |item_list|. - void SetItemList(AppListItemList* item_list); - - void SetSelectedView(views::View* view); - void ClearSelectedView(views::View* view); - void ClearAnySelectedView(); - bool IsSelectedView(const views::View* view) const; - - // Ensures the view is visible. Note that if there is a running page - // transition, this does nothing. - void EnsureViewVisible(const views::View* view); - - void InitiateDrag(AppListItemView* view, - Pointer pointer, - const ui::LocatedEvent& event); - - // Called from AppListItemView when it receives a drag event. - void UpdateDragFromItem(Pointer pointer, - const ui::LocatedEvent& event); - - // Called when the user is dragging an app. |point| is in grid view - // coordinates. - void UpdateDrag(Pointer pointer, const gfx::Point& point); - void EndDrag(bool cancel); - bool IsDraggedView(const views::View* view) const; - - void StartSettingUpSynchronousDrag(); - bool RunSynchronousDrag(); - void CleanUpSynchronousDrag(); - void OnGotShortcutPath(const base::FilePath& path); - - // Set the drag and drop host for application links. - void SetDragAndDropHostOfCurrentAppList( - ApplicationDragAndDropHost* drag_and_drop_host); - - // Prerenders the icons on and around |page_index|. - void Prerender(int page_index); - - bool has_dragged_view() const { return drag_view_ != NULL; } - bool dragging() const { return drag_pointer_ != NONE; } - - // Overridden from views::View: - virtual gfx::Size GetPreferredSize() OVERRIDE; - virtual void Layout() OVERRIDE; - virtual bool OnKeyPressed(const ui::KeyEvent& event) OVERRIDE; - virtual bool OnKeyReleased(const ui::KeyEvent& event) OVERRIDE; - virtual void ViewHierarchyChanged( - const ViewHierarchyChangedDetails& details) OVERRIDE; - virtual bool GetDropFormats( - int* formats, - std::set<OSExchangeData::CustomFormat>* custom_formats) OVERRIDE; - virtual bool CanDrop(const OSExchangeData& data) OVERRIDE; - virtual int OnDragUpdated(const ui::DropTargetEvent& event) OVERRIDE; - - // Stops the timer that triggers a page flip during a drag. - void StopPageFlipTimer(); - - // Return the view model for test purposes. - const views::ViewModel* view_model_for_test() const { return &view_model_; } - - // For test: Return if the drag and drop handler was set. - bool has_drag_and_drop_host_for_test() { return NULL != drag_and_drop_host_; } - - // For test: Return if the drag and drop operation gets dispatched. - bool forward_events_to_drag_and_drop_host_for_test() { - return forward_events_to_drag_and_drop_host_; - } - - void set_is_root_level(bool value) { is_root_level_ = value; } - - private: - friend class test::AppsGridViewTestApi; - - enum DropAttempt { - DROP_FOR_NONE, - DROP_FOR_REORDER, - DROP_FOR_FOLDER, - }; - - // Represents the index to an item view in the grid. - struct Index { - Index() : page(-1), slot(-1) {} - Index(int page, int slot) : page(page), slot(slot) {} - - bool operator==(const Index& other) const { - return page == other.page && slot == other.slot; - } - bool operator!=(const Index& other) const { - return page != other.page || slot != other.slot; - } - - int page; // Which page an item view is on. - int slot; // Which slot in the page an item view is in. - }; - - int tiles_per_page() const { return cols_ * rows_per_page_; } - - // Updates from model. - void Update(); - - // Updates page splits for item views. - void UpdatePaging(); - - // Updates the number of pulsing block views based on AppListModel status and - // number of apps. - void UpdatePulsingBlockViews(); - - views::View* CreateViewForItemAtIndex(size_t index); - - // Convert between the model index and the visual index. The model index - // is the index of the item in AppListModel. The visual index is the Index - // struct above with page/slot info of where to display the item. - Index GetIndexFromModelIndex(int model_index) const; - int GetModelIndexFromIndex(const Index& index) const; - - void SetSelectedItemByIndex(const Index& index); - bool IsValidIndex(const Index& index) const; - - Index GetIndexOfView(const views::View* view) const; - views::View* GetViewAtIndex(const Index& index) const; - - void MoveSelected(int page_delta, int slot_x_delta, int slot_y_delta); - - void CalculateIdealBounds(); - void AnimateToIdealBounds(); - - // Invoked when the given |view|'s current bounds and target bounds are on - // different rows. To avoid moving diagonally, |view| would be put into a - // slot prior |target| and fade in while moving to |target|. In the meanwhile, - // a layer copy of |view| would start at |current| and fade out while moving - // to succeeding slot of |current|. |animate_current| controls whether to run - // fading out animation from |current|. |animate_target| controls whether to - // run fading in animation to |target|. - void AnimationBetweenRows(views::View* view, - bool animate_current, - const gfx::Rect& current, - bool animate_target, - const gfx::Rect& target); - - // Extracts drag location info from |event| into |drag_point|. - void ExtractDragLocation(const ui::LocatedEvent& event, - gfx::Point* drag_point); - - // Calculates |drop_target_| based on |drag_point|. |drag_point| is in the - // grid view's coordinates. When |use_page_button_hovering| is true and - // |drag_point| is hovering on a page button, use the last slot on that page - // as drop target. - void CalculateDropTarget(const gfx::Point& drag_point, - bool use_page_button_hovering); - - // Same as CalculateDropTarget, but with folder UI enabled. The |drop_target_| - // can be either a target for re-ordering, or a target folder to move the - // dragged item into if |drag_view_| enters its re-ordering or folder - // dropping circle. - void CalculateDropTargetWithFolderEnabled(const gfx::Point& drag_point, - bool use_page_button_hovering); - - // Prepares |drag_and_drop_host_| for dragging. |grid_location| contains - // the drag point in this grid view's coordinates. - void StartDragAndDropHostDrag(const gfx::Point& grid_location); - - // Dispatch the drag and drop update event to the dnd host (if needed). - void DispatchDragEventToDragAndDropHost( - const gfx::Point& location_in_screen_coordinates); - - // Starts the page flip timer if |drag_point| is in left/right side page flip - // zone or is over page switcher. - void MaybeStartPageFlipTimer(const gfx::Point& drag_point); - - // Invoked when |page_flip_timer_| fires. - void OnPageFlipTimer(); - - // Updates |model_| to move item represented by |item_view| to |target| slot. - void MoveItemInModel(views::View* item_view, const Index& target); - - // Updates |model_| to move item represented by |item_view| into a folder - // containing item located at |target| slot, also update |view_model_| for - // the related view changes. - void MoveItemToFolder(views::View* item_view, const Index& target); - - // Cancels any context menus showing for app items on the current page. - void CancelContextMenusOnCurrentPage(); - - // Returnes true if |point| lies within the bounds of this grid view plus a - // buffer area surrounding it. - bool IsPointWithinDragBuffer(const gfx::Point& point) const; - - // Handles start page layout and transition animation. - void LayoutStartPage(); - - // Overridden from views::ButtonListener: - virtual void ButtonPressed(views::Button* sender, - const ui::Event& event) OVERRIDE; - - // Overridden from AppListItemListObserver: - virtual void OnListItemAdded(size_t index, AppListItemModel* item) OVERRIDE; - virtual void OnListItemRemoved(size_t index, AppListItemModel* item) OVERRIDE; - virtual void OnListItemMoved(size_t from_index, - size_t to_index, - AppListItemModel* item) OVERRIDE; - - // Overridden from PaginationModelObserver: - virtual void TotalPagesChanged() OVERRIDE; - virtual void SelectedPageChanged(int old_selected, int new_selected) OVERRIDE; - virtual void TransitionStarted() OVERRIDE; - virtual void TransitionChanged() OVERRIDE; - - // Overridden from AppListModelObserver: - virtual void OnAppListModelStatusChanged() OVERRIDE; - - // Hide a given view temporarily without losing (mouse) events and / or - // changing the size of it. If |immediate| is set the change will be - // immediately applied - otherwise it will change gradually. - // If |hide| is set the view will get hidden, otherwise it gets shown. - void SetViewHidden(views::View* view, bool hide, bool immediate); - - // Whether the folder drag-and-drop UI should be enabled. - bool EnableFolderDragDropUI(); - - // Whether target specified by |drap_target| can accept more items to be - // dropped into it. - bool CanDropIntoTarget(const Index& drop_target); - - // Returns the visual index of the nearest tile in which |drag_view_| enters - // either its re-ordering or folder dropping circle. - Index GetNearestTileForDragView(); - - // Calculates |nearest_tile| in which |vertex| of the |drag_view| is - // enclosed. - // *|nearest_tile| and *|d_min| will be updated based on the calculation. - // *|d_min| is the distance between |nearest_tile| and |drag_view_|. - void CalculateNearestTileForVertex( - const gfx::Point& vertex, Index* nearest_tile, int* d_min); - - // Returns the bounds of the tile in which |point| is enclosed if there - // is a valid item sits on the tile. - gfx::Rect GetTileBoundsForPoint(const gfx::Point& point, Index* tile_index); - - // Gets the bounds of the tile located at |row| and |col| on current page. - gfx::Rect GetTileBounds(int row, int col) const; - - // Gets the item view located at |slot| on the current page. If there is - // no item located at |slot|, returns NULL. - views::View* GetViewAtSlotOnCurrentPage(int slot); - - // Sets state of the view with |target_index| to |is_target_folder| for - // dropping |drag_view_|. - void SetAsFolderDroppingTarget(const Index& target_index, - bool is_target_folder); - - // Invoked when |reorder_timer_| fires to show re-order preview UI. - void OnReorderTimer(); - - // Invoked when |folder_dropping_timer_| fires to show folder dropping - // preview UI. - void OnFolderDroppingTimer(); - - AppListModel* model_; // Owned by AppListView. - AppListItemList* item_list_; // Not owned. - AppsGridViewDelegate* delegate_; - PaginationModel* pagination_model_; // Owned by AppListController. - PageSwitcher* page_switcher_view_; // Owned by views hierarchy. - views::WebView* start_page_view_; // Owned by views hierarchy. - - gfx::Size icon_size_; - int cols_; - int rows_per_page_; - - // Tracks app item views. There is a view per item in |model_|. - views::ViewModel view_model_; - - // Tracks pulsing block views. - views::ViewModel pulsing_blocks_model_; - - views::View* selected_view_; - - AppListItemView* drag_view_; - - // The point where the drag started in AppListItemView coordinates. - gfx::Point drag_view_offset_; - - // The point where the drag started in GridView coordinates. - gfx::Point drag_start_grid_view_; - - // The location of |drag_view_| when the drag started. - gfx::Point drag_view_start_; - - // Page the drag started on. - int drag_start_page_; - -#if defined(OS_WIN) - // Created when a drag is started (ie: drag exceeds the drag threshold), but - // not Run() until supplied with a shortcut path. - scoped_refptr<SynchronousDrag> synchronous_drag_; -#endif - - Pointer drag_pointer_; - Index drop_target_; - DropAttempt drop_attempt_; - - // Timer for re-ordering the |drop_target_| and |drag_view_|. - base::OneShotTimer<AppsGridView> reorder_timer_; - - // Timer for dropping |drag_view_| into the folder containing - // the |drop_target_|. - base::OneShotTimer<AppsGridView> folder_dropping_timer_; - - // An application target drag and drop host which accepts dnd operations. - ApplicationDragAndDropHost* drag_and_drop_host_; - - // The drag operation is currently inside the dnd host and events get - // forwarded. - bool forward_events_to_drag_and_drop_host_; - - // Last mouse drag location in this view's coordinates. - gfx::Point last_drag_point_; - - // Timer to auto flip page when dragging an item near the left/right edges. - base::OneShotTimer<AppsGridView> page_flip_timer_; - - // Target page to switch to when |page_flip_timer_| fires. - int page_flip_target_; - - // Delay in milliseconds of when |page_flip_timer_| should fire after user - // drags an item near the edges. - int page_flip_delay_in_ms_; - - views::BoundsAnimator bounds_animator_; - - // If true, AppsGridView is rending items at the root level of the app list. - bool is_root_level_; - - DISALLOW_COPY_AND_ASSIGN(AppsGridView); -}; - -} // namespace app_list - -#endif // UI_APP_LIST_VIEWS_APPS_GRID_VIEW_H_ |