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