blob: 4c2491221bc629c64cbfb1f8535ab3fcf2e8198b [file] [log] [blame]
// 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.
#include <vector>
#include "base/basictypes.h"
#include "base/callback.h"
#include "content/common/content_export.h"
#include "content/common/drag_event_source_info.h"
#include "third_party/WebKit/public/web/WebDragOperation.h"
class SkBitmap;
namespace gfx {
class ImageSkia;
class Rect;
class Vector2d;
namespace ui {
class GestureEvent;
class MouseEvent;
namespace content {
class RenderFrameHost;
struct ContextMenuParams;
struct DropData;
struct MenuItem;
// This class provides a way for the RenderViewHost to reach out to its
// delegate's view. It only needs to be implemented by embedders if they don't
// use the default WebContentsView implementations.
class CONTENT_EXPORT RenderViewHostDelegateView {
// A context menu should be shown, to be built using the context information
// provided in the supplied params.
virtual void ShowContextMenu(RenderFrameHost* render_frame_host,
const ContextMenuParams& params) {}
// The user started dragging content of the specified type within the
// RenderView. Contextual information about the dragged content is supplied
// by DropData. If the delegate's view cannot start the drag for /any/
// reason, it must inform the renderer that the drag has ended; otherwise,
// this results in bugs like
virtual void StartDragging(const DropData& drop_data,
blink::WebDragOperationsMask allowed_ops,
const gfx::ImageSkia& image,
const gfx::Vector2d& image_offset,
const DragEventSourceInfo& event_info) {}
// The page wants to update the mouse cursor during a drag & drop operation.
// |operation| describes the current operation (none, move, copy, link.)
virtual void UpdateDragCursor(blink::WebDragOperation operation) {}
// Notification that view for this delegate got the focus.
virtual void GotFocus() {}
// Callback to inform the browser that the page is returning the focus to
// the browser's chrome. If reverse is true, it means the focus was
// retrieved by doing a Shift-Tab.
virtual void TakeFocus(bool reverse) {}
#if defined(OS_MACOSX) || defined(OS_ANDROID)
// Shows a popup menu with the specified items.
// This method should call RenderFrameHost::DidSelectPopupMenuItem[s]() or
// RenderFrameHost::DidCancelPopupMenu() based on the user action.
virtual void ShowPopupMenu(RenderFrameHost* render_frame_host,
const gfx::Rect& bounds,
int item_height,
double item_font_size,
int selected_item,
const std::vector<MenuItem>& items,
bool right_aligned,
bool allow_multiple_selection) {};
// Hides a popup menu opened by ShowPopupMenu().
virtual void HidePopupMenu() {};
#if defined(USE_AURA)
// Shows a Link Disambiguation Popup. |target_rect| is the area the user
// touched that resulted in ambiguity, in DIPs in the host's coordinate
// system, |zoomed_bitmap| is an enlarged image of that |target_rect|, and
// |callback| is for forwarding on to the original scale web content.
virtual void ShowDisambiguationPopup(
const gfx::Rect& target_rect,
const SkBitmap& zoomed_bitmap,
const base::Callback<void(ui::GestureEvent*)>& gesture_cb,
const base::Callback<void(ui::MouseEvent*)>& mouse_cb) {}
// Hides the Link Disambiguation Popup, if it was showing, otherwise does
// nothing.
virtual void HideDisambiguationPopup() {}
virtual ~RenderViewHostDelegateView() {}
} // namespace content