public:

typedef cef_drag_operations_mask_t DragOperation;

typedef cef_drag_operations_mask_t DragOperationsMask;

typedef cef_paint_element_type_t PaintElementType;

typedef std::vector<CefRect> RectList;

typedef cef_text_input_mode_t TextInputMode;

///

/// Return the handler for accessibility notifications. If no handler is

/// provided the default implementation will be used.

///

/*--cef()--*/

virtual CefRefPtr<CefAccessibilityHandler> GetAccessibilityHandler() {

return nullptr;

}

///

/// Called to retrieve the root window rectangle in screen DIP coordinates.

/// Return true if the rectangle was provided. If this method returns false

/// the rectangle from GetViewRect will be used.

///

/*--cef()--*/

virtual bool GetRootScreenRect(CefRefPtr<CefBrowser> browser, CefRect& rect) {

return false;

}

///

/// Called to retrieve the view rectangle in screen DIP coordinates. This

/// method must always provide a non-empty rectangle.

///

/*--cef()--*/

virtual void GetViewRect(CefRefPtr<CefBrowser> browser, CefRect& rect) = 0;

///

/// Called to retrieve the translation from view DIP coordinates to screen

/// coordinates. Windows/Linux should provide screen device (pixel)

/// coordinates and MacOS should provide screen DIP coordinates. Return true

/// if the requested coordinates were provided.

///

/*--cef()--*/

virtual bool GetScreenPoint(CefRefPtr<CefBrowser> browser,

int viewX,

int viewY,

int& screenX,

int& screenY) {

return false;

}

///

/// Called to allow the client to fill in the CefScreenInfo object with

/// appropriate values. Return true if the |screen_info| structure has been

/// modified.

///

/// If the screen info rectangle is left empty the rectangle from GetViewRect

/// will be used. If the rectangle is still empty or invalid popups may not be

/// drawn correctly.

///

/*--cef()--*/

virtual bool GetScreenInfo(CefRefPtr<CefBrowser> browser,

CefScreenInfo& screen_info) {

return false;

}

///

/// Called when the browser wants to show or hide the popup widget. The popup

/// should be shown if |show| is true and hidden if |show| is false.

///

/*--cef()--*/

virtual void OnPopupShow(CefRefPtr<CefBrowser> browser, bool show) {}

///

/// Called when the browser wants to move or resize the popup widget. |rect|

/// contains the new location and size in view coordinates.

///

/*--cef()--*/

virtual void OnPopupSize(CefRefPtr<CefBrowser> browser, const CefRect& rect) {

}

///

/// Called when an element should be painted. Pixel values passed to this

/// method are scaled relative to view coordinates based on the value of

/// CefScreenInfo.device_scale_factor returned from GetScreenInfo. |type|

/// indicates whether the element is the view or the popup widget. |buffer|

/// contains the pixel data for the whole image. |dirtyRects| contains the set

/// of rectangles in pixel coordinates that need to be repainted. |buffer|

/// will be |width|*|height|*4 bytes in size and represents a BGRA image with

/// an upper-left origin. This method is only called when

/// CefWindowInfo::shared_texture_enabled is set to false.

///

/*--cef()--*/

virtual void OnPaint(CefRefPtr<CefBrowser> browser,

PaintElementType type,

const RectList& dirtyRects,

const void* buffer,

int width,

int height) = 0;

///

/// Called when an element has been rendered to the shared texture handle.

/// |type| indicates whether the element is the view or the popup widget.

/// |dirtyRects| contains the set of rectangles in pixel coordinates that need

/// to be repainted. |info| contains the shared handle; on Windows it is a

/// HANDLE to a texture that can be opened with D3D11 OpenSharedResource1 or

/// D3D12 OpenSharedHandle, on macOS it is an IOSurface pointer that can be

/// opened with Metal or OpenGL, and on Linux it contains several planes, each

/// with an fd to the underlying system native buffer.

///

/// The underlying implementation uses a pool to deliver frames. As a result,

/// the handle may differ every frame depending on how many frames are

/// in-progress. The handle's resource cannot be cached and cannot be accessed

/// outside of this callback. It should be reopened each time this callback is

/// executed and the contents should be copied to a texture owned by the

/// client application. The contents of |info| will be released back to the

/// pool after this callback returns.

///

/*--cef()--*/

virtual void OnAcceleratedPaint(CefRefPtr<CefBrowser> browser,

PaintElementType type,

const RectList& dirtyRects,

const CefAcceleratedPaintInfo& info) {}

///

/// Called to retrieve the size of the touch handle for the specified

/// |orientation|.

///

/*--cef()--*/

virtual void GetTouchHandleSize(CefRefPtr<CefBrowser> browser,

cef_horizontal_alignment_t orientation,

CefSize& size) {}

///

/// Called when touch handle state is updated. The client is responsible for

/// rendering the touch handles.

///

/*--cef()--*/

virtual void OnTouchHandleStateChanged(CefRefPtr<CefBrowser> browser,

const CefTouchHandleState& state) {}

///

/// Called when the user starts dragging content in the web view. Contextual

/// information about the dragged content is supplied by |drag_data|.

/// (|x|, |y|) is the drag start location in screen coordinates.

/// OS APIs that run a system message loop may be used within the

/// StartDragging call.

///

/// Return false to abort the drag operation. Don't call any of

/// CefBrowserHost::DragSource*Ended* methods after returning false.

///

/// Return true to handle the drag operation. Call

/// CefBrowserHost::DragSourceEndedAt and DragSourceSystemDragEnded either

/// synchronously or asynchronously to inform the web view that the drag

/// operation has ended.

///

/*--cef()--*/

virtual bool StartDragging(CefRefPtr<CefBrowser> browser,

CefRefPtr<CefDragData> drag_data,

DragOperationsMask allowed_ops,

int x,

int y) {

return false;

}

///

/// Called when the web view wants to update the mouse cursor during a

/// drag & drop operation. |operation| describes the allowed operation

/// (none, move, copy, link).

///

/*--cef()--*/

virtual void UpdateDragCursor(CefRefPtr<CefBrowser> browser,

DragOperation operation) {}

///

/// Called when the scroll offset has changed.

///

/*--cef()--*/

virtual void OnScrollOffsetChanged(CefRefPtr<CefBrowser> browser,

double x,

double y) {}

///

/// Called when the IME composition range has changed. |selected_range| is the

/// range of characters that have been selected. |character_bounds| is the

/// bounds of each character in view coordinates.

///

/*--cef()--*/

virtual void OnImeCompositionRangeChanged(CefRefPtr<CefBrowser> browser,

const CefRange& selected_range,

const RectList& character_bounds) {}

///

/// Called when text selection has changed for the specified |browser|.

/// |selected_text| is the currently selected text and |selected_range| is

/// the character range.

///

/*--cef(optional_param=selected_text,optional_param=selected_range)--*/

virtual void OnTextSelectionChanged(CefRefPtr<CefBrowser> browser,

const CefString& selected_text,

const CefRange& selected_range) {}

///

/// Called when an on-screen keyboard should be shown or hidden for the

/// specified |browser|. |input_mode| specifies what kind of keyboard

/// should be opened. If |input_mode| is CEF_TEXT_INPUT_MODE_NONE, any

/// existing keyboard for this browser should be hidden.

///

/*--cef()--*/

virtual void OnVirtualKeyboardRequested(CefRefPtr<CefBrowser> browser,

TextInputMode input_mode) {}