content/browser/renderer_host/render_view_host_delegate_view.h

   1 // Copyright (c) 2012 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 #ifndef CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_DELEGATE_VIEW_H_
   6 #define CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_DELEGATE_VIEW_H_
   7
   8 #include <vector>
   9
  10 #include "base/basictypes.h"
  11 #include "content/common/content_export.h"
  12 #include "content/common/drag_event_source_info.h"
  13 #include "third_party/WebKit/public/web/WebDragOperation.h"
  14
  15 class SkBitmap;
  16
  17 namespace gfx {
  18 class ImageSkia;
  19 class Rect;
  20 class Vector2d;
  21 }
  22
  23 namespace content {
  24 class RenderFrameHost;
  25 struct ContextMenuParams;
  26 struct DropData;
  27 struct MenuItem;
  28
  29 // This class provides a way for the RenderViewHost to reach out to its
  30 // delegate's view. It only needs to be implemented by embedders if they don't
  31 // use the default WebContentsView implementations.
  32 class CONTENT_EXPORT RenderViewHostDelegateView {
  33  public:
  34   // A context menu should be shown, to be built using the context information
  35   // provided in the supplied params.
  36   virtual void ShowContextMenu(RenderFrameHost* render_frame_host,
  37                                const ContextMenuParams& params) {}
  38
  39   // The user started dragging content of the specified type within the
  40   // RenderView. Contextual information about the dragged content is supplied
  41   // by DropData. If the delegate's view cannot start the drag for /any/
  42   // reason, it must inform the renderer that the drag has ended; otherwise,
  43   // this results in bugs like http://crbug.com/157134.
  44   virtual void StartDragging(const DropData& drop_data,
  45                              blink::WebDragOperationsMask allowed_ops,
  46                              const gfx::ImageSkia& image,
  47                              const gfx::Vector2d& image_offset,
  48                              const DragEventSourceInfo& event_info) {}
  49
  50   // The page wants to update the mouse cursor during a drag & drop operation.
  51   // |operation| describes the current operation (none, move, copy, link.)
  52   virtual void UpdateDragCursor(blink::WebDragOperation operation) {}
  53
  54   // Notification that view for this delegate got the focus.
  55   virtual void GotFocus() {}
  56
  57   // Callback to inform the browser that the page is returning the focus to
  58   // the browser's chrome. If reverse is true, it means the focus was
  59   // retrieved by doing a Shift-Tab.
  60   virtual void TakeFocus(bool reverse) {}
  61
  62 #if defined(OS_MACOSX) || defined(OS_ANDROID)
  63   // Shows a popup menu with the specified items.
  64   // This method should call RenderFrameHost::DidSelectPopupMenuItem[s]() or
  65   // RenderFrameHost::DidCancelPopupMenu() based on the user action.
  66   virtual void ShowPopupMenu(RenderFrameHost* render_frame_host,
  67                              const gfx::Rect& bounds,
  68                              int item_height,
  69                              double item_font_size,
  70                              int selected_item,
  71                              const std::vector<MenuItem>& items,
  72                              bool right_aligned,
  73                              bool allow_multiple_selection) {};
  74
  75   // Hides a popup menu opened by ShowPopupMenu().
  76   virtual void HidePopupMenu() {};
  77 #endif
  78
  79  protected:
  80   virtual ~RenderViewHostDelegateView() {}
  81 };
  82
  83 }  // namespace content
  84
  85 #endif  // CONTENT_BROWSER_RENDERER_HOST_RENDER_VIEW_HOST_DELEGATE_VIEW_H_