Allow custom context menus to be requested.

content/public/renderer/render_view.h

 // 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 CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_
 #define CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_
 
 #include "base/basictypes.h"
 #include "base/string16.h"
 #include "content/common/content_export.h"
@@ skipping 20 matching lines @@
 namespace gfx {
 class Size;
 }
 
 namespace webkit {
 struct WebPluginInfo;
 }
 
 namespace content {
 
+class ContextMenuClient;
+struct ContextMenuParams;

[jam, 2012/10/10 04:01:43]

nit: put the struct after class RenderViewVistor

 class RenderViewVisitor;
 
 class CONTENT_EXPORT RenderView : public IPC::Sender {
  public:
   // Returns the RenderView containing the given WebView.
   static RenderView* FromWebView(WebKit::WebView* webview);
 
   // Visit all RenderViews with a live WebView (i.e., RenderViews that have
   // been closed but not yet destroyed are excluded).
   static void ForEach(RenderViewVisitor* visitor);
@@ skipping 50 matching lines @@
   virtual int GetEnabledBindings() const = 0;
 
   // Whether content state (such as form state, scroll position and page
   // contents) should be sent to the browser immediately. This is normally
   // false, but set to true by some tests.
   virtual bool GetContentStateImmediately() const = 0;
 
   // Filtered time per frame based on UpdateRect messages.
   virtual float GetFilteredTimePerFrame() const = 0;
 
-  // Shows a context menu with commands relevant to a specific element on
-  // the given frame. Additional context data is supplied.
-  virtual void ShowContextMenu(WebKit::WebFrame* frame,
-                               const WebKit::WebContextMenuData& data) = 0;
+  // Shows a context menu with the given information. The given client will
+  // be called with the result. The client pointer is owned by the caller and
+  // must remain valid as long as the RenderView is alive.
+  //
+  // The request ID will be returned by this function. This is passed to the
+  // client functions for identification.
+  //
+  // Note: if you end up having clients outliving the RenderView, we should add
+  // a CancelContextMenuCallback function that takes a request id.
+  virtual int ShowContextMenu(ContextMenuClient* client,
+                              const ContextMenuParams& params) = 0;
 
   // Returns the current visibility of the WebView.
   virtual WebKit::WebPageVisibilityState GetVisibilityState() const = 0;
 
   // Displays a modal alert dialog containing the given message.  Returns
   // once the user dismisses the dialog.
   virtual void RunModalAlertDialog(WebKit::WebFrame* frame,
                                    const WebKit::WebString& message) = 0;
 
   // The client should handle the navigation externally.
   virtual void LoadURLExternally(
       WebKit::WebFrame* frame,
       const WebKit::WebURLRequest& request,
       WebKit::WebNavigationPolicy policy) = 0;
 
   // Notifies the renderer that a paint is to be generated for the size
   // passed in.
   virtual void Repaint(const gfx::Size& size) = 0;
 
  protected:
   virtual ~RenderView() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_RENDERER_RENDER_VIEW_H_