public:

typedef cef_event_flags_t EventFlags;

///

// Called before a context menu is displayed. |params| provides information

// about the context menu state. |model| initially contains the default

// context menu. The |model| can be cleared to show no context menu or

// modified to show a custom menu. Do not keep references to |params| or

// |model| outside of this callback.

///

/*--cef()--*/

virtual void OnBeforeContextMenu(CefRefPtr<CefBrowser> browser,

CefRefPtr<CefFrame> frame,

CefRefPtr<CefContextMenuParams> params,

CefRefPtr<CefMenuModel> model) {}

///

// Called to execute a command selected from the context menu. Return true if

// the command was handled or false for the default implementation. See

// cef_menu_id_t for the command ids that have default implementations. All

// user-defined command ids should be between MENU_ID_USER_FIRST and

// MENU_ID_USER_LAST. |params| will have the same values as what was passed to

// OnBeforeContextMenu(). Do not keep a reference to |params| outside of this

// callback.

///

/*--cef()--*/

virtual bool OnContextMenuCommand(CefRefPtr<CefBrowser> browser,

CefRefPtr<CefFrame> frame,

CefRefPtr<CefContextMenuParams> params,

int command_id,

EventFlags event_flags) { return false; }

///

// Called when the context menu is dismissed irregardless of whether the menu

// was empty or a command was selected.

///

/*--cef()--*/

virtual void OnContextMenuDismissed(CefRefPtr<CefBrowser> browser,

CefRefPtr<CefFrame> frame) {}

public:

typedef cef_context_menu_type_flags_t TypeFlags;

typedef cef_context_menu_media_type_t MediaType;

typedef cef_context_menu_media_state_flags_t MediaStateFlags;

typedef cef_context_menu_edit_state_flags_t EditStateFlags;

///

// Returns the X coordinate of the mouse where the context menu was invoked.

// Coords are relative to the associated RenderView's origin.

///

/*--cef()--*/

virtual int GetXCoord() =0;

///

// Returns the Y coordinate of the mouse where the context menu was invoked.

// Coords are relative to the associated RenderView's origin.

///

/*--cef()--*/

virtual int GetYCoord() =0;

///

// Returns flags representing the type of node that the context menu was

// invoked on.

///

/*--cef(default_retval=CM_TYPEFLAG_NONE)--*/

virtual TypeFlags GetTypeFlags() =0;

///

// Returns the URL of the link, if any, that encloses the node that the

// context menu was invoked on.

///

/*--cef()--*/

virtual CefString GetLinkUrl() =0;

///

// Returns the link URL, if any, to be used ONLY for "copy link address". We

// don't validate this field in the frontend process.

///

/*--cef()--*/

virtual CefString GetUnfilteredLinkUrl() =0;

///

// Returns the source URL, if any, for the element that the context menu was

// invoked on. Example of elements with source URLs are img, audio, and video.

///

/*--cef()--*/

virtual CefString GetSourceUrl() =0;

///

// Returns true if the context menu was invoked on an image which has

// non-empty contents.

///

/*--cef()--*/

virtual bool HasImageContents() =0;

///

// Returns the URL of the top level page that the context menu was invoked on.

///

/*--cef()--*/

virtual CefString GetPageUrl() =0;

///

// Returns the URL of the subframe that the context menu was invoked on.

///

/*--cef()--*/

virtual CefString GetFrameUrl() =0;

///

// Returns the character encoding of the subframe that the context menu was

// invoked on.

///

/*--cef()--*/

virtual CefString GetFrameCharset() =0;

///

// Returns the type of context node that the context menu was invoked on.

///

/*--cef(default_retval=CM_MEDIATYPE_NONE)--*/

virtual MediaType GetMediaType() =0;

///

// Returns flags representing the actions supported by the media element, if

// any, that the context menu was invoked on.

///

/*--cef(default_retval=CM_MEDIAFLAG_NONE)--*/

virtual MediaStateFlags GetMediaStateFlags() =0;

///

// Returns the text of the selection, if any, that the context menu was

// invoked on.

///

/*--cef()--*/

virtual CefString GetSelectionText() =0;

///

// Returns true if the context menu was invoked on an editable node.

///

/*--cef()--*/

virtual bool IsEditable() =0;

///

// Returns true if the context menu was invoked on an editable node where

// speech-input is enabled.

///

/*--cef()--*/

virtual bool IsSpeechInputEnabled() =0;

///

// Returns flags representing the actions supported by the editable node, if

// any, that the context menu was invoked on.

///

/*--cef(default_retval=CM_EDITFLAG_NONE)--*/

virtual EditStateFlags GetEditStateFlags() =0;