# Class TCefDisplayHandlerOwn

Description
Hierarchy
Fields
Methods
Properties

## Unit

uCEFDisplayHandler

## Declaration

`type TCefDisplayHandlerOwn = class(TCefBaseRefCountedOwn, ICefDisplayHandler)`

## Description

Event handler related to browser display state. The functions of this interface will be called on the UI thread.

<see href="https://bitbucket.org/chromiumembedded/cef/src/master/include/capi/cef_display_handler_capi.h">CEF source file: /include/capi/cef_display_handler_capi.h (cef_display_handler_t))

## Hierarchy

- TInterfacedObject
- TCefBaseRefCountedOwn
- TCefDisplayHandlerOwn

## Overview

### Methods

| `procedure OnAddressChange(const browser: ICefBrowser; const frame: ICefFrame; const url: ustring); virtual;`
| `procedure OnTitleChange(const browser: ICefBrowser; const title: ustring); virtual;`
| `procedure OnFaviconUrlChange(const browser: ICefBrowser; const iconUrls: TStrings); virtual;`
| `procedure OnFullScreenModeChange(const browser: ICefBrowser; fullscreen: Boolean); virtual;`
| `function OnTooltip(const browser: ICefBrowser; var text: ustring): Boolean; virtual;`
| `procedure OnStatusMessage(const browser: ICefBrowser; const value: ustring); virtual;`
| `function OnConsoleMessage(const browser: ICefBrowser; level: TCefLogSeverity; const message_, source: ustring; line: Integer): Boolean; virtual;`
| `function OnAutoResize(const browser: ICefBrowser; const new_size: PCefSize): Boolean; virtual;`
| `procedure OnLoadingProgressChange(const browser: ICefBrowser; const progress: double); virtual;`
| `procedure OnCursorChange(const browser: ICefBrowser; cursor_: TCefCursorHandle; CursorType: TCefCursorType; const customCursorInfo: PCefCursorInfo; var aResult : boolean); virtual;`
| `procedure OnMediaAccessChange(const browser: ICefBrowser; has_video_access, has_audio_access: boolean); virtual;`
| `function OnContentsBoundsChange(const browser: ICefBrowser; const new_bounds: PCefRect): Boolean; virtual;`
| `function GetRootWindowScreenRect(const browser: ICefBrowser; rect_: PCefRect): Boolean; virtual;`
| `procedure RemoveReferences; virtual;`
| `constructor Create; virtual;`

## Description

### Methods

| `procedure OnAddressChange(const browser: ICefBrowser; const frame: ICefFrame; const url: ustring); virtual;`
Called when a frame's address has changed.

| `procedure OnTitleChange(const browser: ICefBrowser; const title: ustring); virtual;`
Called when the page title changes.

| `procedure OnFaviconUrlChange(const browser: ICefBrowser; const iconUrls: TStrings); virtual;`
Called when the page icon changes.

| `procedure OnFullScreenModeChange(const browser: ICefBrowser; fullscreen: Boolean); virtual;`

Called when web content in the page has toggled fullscreen mode. If |fullscreen| is true (1) the content will automatically be sized to fill the browser content area. If |fullscreen| is false (0) the content will automatically return to its original size and position. With Alloy style the client is responsible for triggering the fullscreen transition (for example, by calling ICefWindow.SetFullscreen when using Views). With Chrome style the fullscreen transition will be triggered automatically. The ICefWindowDelegate.OnWindowFullscreenTransition function will be called during the fullscreen transition for notification purposes.

| `function OnTooltip(const browser: ICefBrowser; var text: ustring): Boolean; virtual;`

Called when the browser is about to display a tooltip. |text| contains the text that will be displayed in the tooltip. To handle the display of the tooltip yourself return true (1). Otherwise, you can optionally modify |text| and then return false (0) to allow the browser to display the tooltip. When window rendering is disabled the application is responsible for drawing tooltips and the return value is ignored.

| `procedure OnStatusMessage(const browser: ICefBrowser; const value: ustring); virtual;`
Called when the browser receives a status message. |value| contains the text that will be displayed in the status message.

| `function OnConsoleMessage(const browser: ICefBrowser; level: TCefLogSeverity; const message_, source: ustring; line: Integer): Boolean; virtual;`
Called to display a console message. Return true (1) to stop the message from being output to the console.

| `function OnAutoResize(const browser: ICefBrowser; const new_size: PCefSize): Boolean; virtual;`
Called when auto-resize is enabled via ICefBrowserHost.SetAutoResizeEnabled and the contents have auto- resized. |new_size| will be the desired size in DIP coordinates. Return true (1) if the resize was handled or false (0) for default handling.

| `procedure OnLoadingProgressChange(const browser: ICefBrowser; const progress: double); virtual;`
Called when the overall page loading progress has changed. |progress| ranges from 0.0 to 1.0.

| `procedure OnCursorChange(const browser: ICefBrowser; cursor_: TCefCursorHandle; CursorType: TCefCursorType; const customCursorInfo: PCefCursorInfo; var aResult : boolean); virtual;`
Called when the browser's cursor has changed. If |type| is CT_CUSTOM then |custom_cursor_info| will be populated with the custom cursor information. Return true (1) if the cursor change was handled or false (0) for default handling.

| `procedure OnMediaAccessChange(const browser: ICefBrowser; has_video_access, has_audio_access: boolean); virtual;`
Called when the browser's access to an audio and/or video source has changed.

| `function OnContentsBoundsChange(const browser: ICefBrowser; const new_bounds: PCefRect): Boolean; virtual;`

Called when JavaScript is requesting new bounds via window.moveTo/By() or window.resizeTo/By(). |new_bounds| are in DIP screen coordinates.

With Views-hosted browsers |new_bounds| are the desired bounds for the containing ICefWindow and may be passed directly to ICefWindow.SetBounds. With external (client-provided) parent on macOS and Windows |new_bounds| are the desired frame bounds for the containing root window. With other non-Views browsers |new_bounds| are the desired bounds for the browser content only unless the client implements either ICefDisplayHandler.GetRootWindowScreenRect for windowed browsers or ICefRenderHandler.GetWindowScreenRect for windowless browsers. Clients may expand browser content bounds to window bounds using OS-specific or ICefDisplay functions.

Return true (1) if this function was handled or false (0) for default handling. Default move/resize behavior is only provided with Views-hosted Chrome style browsers.

| `function GetRootWindowScreenRect(const browser: ICefBrowser; rect_: PCefRect): Boolean; virtual;`
Called to retrieve the external (client-provided) root window rectangle in screen DIP coordinates. Only called for windowed browsers on Windows and Linux. Return true (1) if the rectangle was provided. Return false (0) to use the root window bounds on Windows or the browser content bounds on Linux. For additional usage details see ICefBrowserHost.NotifyScreenInfoChanged.

| `procedure RemoveReferences; virtual;`
Custom procedure to clear all references.

| `constructor Create; virtual;`
This item has no description.

Generated by PasDoc 0.17.0.snapshot.