Click or drag to resize
CfxRenderHandler Class

[This is preliminary documentation and is subject to change.]

Implement this structure to handle events when window rendering is disabled. The functions of this structure will be called on the UI thread.
Inheritance Hierarchy
SystemObject
  ChromiumCfxObject
    ChromiumCfxBase
      ChromiumCfxClientBase
        ChromiumCfxRenderHandler

Namespace: Chromium
Assembly: ChromiumFX (in ChromiumFX.dll)
Syntax
public class CfxRenderHandler : CfxClientBase

The CfxRenderHandler type exposes the following members.

Constructors
  NameDescription
Public methodCfxRenderHandler
Initializes a new instance of the CfxRenderHandler class
Top
Properties
  NameDescription
Public propertyCallbacksDisabled
When true, all CEF callback events are disabled for this handler. Incoming callbacks will return default values to CEF.
(Inherited from CfxClientBase.)
Public propertyNativePtr
Provides access to the underlying native cef struct. This is a refcounted client struct derived from cef_base_t. Add a ref in order to keep it alive when this managed object go out of scope.
(Inherited from CfxClientBase.)
Top
Events
  NameDescription
Public eventGetRootScreenRect
Called to retrieve the root window rectangle in screen coordinates. Return true (1) if the rectangle was provided.
Public eventGetScreenInfo
Called to allow the client to fill in the CfxScreenInfo object with appropriate values. Return true (1) if the |ScreenInfo| structure has been modified. If the screen info rectangle is left NULL the rectangle from GetViewRect will be used. If the rectangle is still NULL or invalid popups may not be drawn correctly.
Public eventGetScreenPoint
Called to retrieve the translation from view coordinates to actual screen coordinates. Return true (1) if the screen coordinates were provided.
Public eventGetViewRect
Called to retrieve the view rectangle which is relative to screen coordinates. Return true (1) if the rectangle was provided.
Public eventOnCursorChange
Called when the browser's cursor has changed. If |Type| is CT_CUSTOM then |CustomCursorInfo| will be populated with the custom cursor information.
Public eventOnImeCompositionRangeChanged
Called when the IME composition range has changed. |SelectedRange| is the range of characters that have been selected. |CharacterBounds| is the bounds of each character in view coordinates.
Public eventOnPaint
Called when an element should be painted. Pixel values passed to this function are scaled relative to view coordinates based on the value of CfxScreenInfo.DeviceScaleFactor 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.
Public eventOnPopupShow
Called when the browser wants to show or hide the popup widget. The popup should be shown if |Show| is true (1) and hidden if |Show| is false (0).
Public eventOnPopupSize
Called when the browser wants to move or resize the popup widget. |Rect| contains the new location and size in view coordinates.
Public eventOnScrollOffsetChanged
Called when the scroll offset has changed.
Public eventStartDragging
Called when the user starts dragging content in the web view. Contextual information about the dragged content is supplied by |DragData|. (|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 (0) to abort the drag operation. Don't call any of CfxBrowserHost.DragSource*Ended* functions after returning false (0). Return true (1) to handle the drag operation. Call CfxBrowserHost.DragSourceEndedAt and DragSourceSystemDragEnded either synchronously or asynchronously to inform the web view that the drag operation has ended.
Public eventUpdateDragCursor
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).
Top
Remarks
See also the original CEF documentation in cef/include/capi/cef_render_handler_capi.h.
See Also