Allow custom context menus to be requested.

content/public/renderer/context_menu_client.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_CONTEXT_MENU_CLIENT_H_
+#define CONTENT_PUBLIC_RENDERER_CONTEXT_MENU_CLIENT_H_
+
+#include "base/basictypes.h"
+#include "content/common/content_export.h"
+
+namespace content {
+
+// This mirrors the WebKit API in that the "action selected" and "menu closed"
+// events are separate. When the user selects and item you'll get both events.
+// If the user clicks somewhere else and cancels the menu, you'll just get the
+// "closed" event.
+class CONTENT_EXPORT ContextMenuClient {
+ public:
+  // Called when the user selects a context menu item. The request ID will be
+  // the value returned by RenderView.ShowCustomContextMenu. This will be
+  // followed by a call to OnCustomContextMenuClosed.
+  virtual void OnCustomContextMenuAction(int request_id, unsigned action) = 0;

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

nit: since ContextMenu is in the interface name, it's a bit redundant to put it
in the callback names? i.e. just OnMenuAction and OnMenuClosed?

[brettw, 2012/10/10 05:10:17]

I was originally thinking this would be implemented by some big classes where it
might get confusing, but it seems OK. Done.

+
+  // Called when the context menu is closed. The request ID will be the value
+  // returned by RenderView.ShowCustomContextMenu.
+  virtual void OnCustomContextMenuClosed(int request_id) = 0;
+
+ protected:
+  virtual ~ContextMenuClient() {}
+};
+
+}  // namespace content
+
+#endif  // CONTENT_PUBLIC_RENDERER_CONTEXT_MENU_CLIENT_H_