mirror of
https://github.com/salvadordf/CEF4Delphi.git
synced 2024-11-15 15:55:56 +01:00
272 lines
11 KiB
ObjectPascal
272 lines
11 KiB
ObjectPascal
// ************************************************************************
|
|
// ***************************** CEF4Delphi *******************************
|
|
// ************************************************************************
|
|
//
|
|
// CEF4Delphi is based on DCEF3 which uses CEF to embed a chromium-based
|
|
// browser in Delphi applications.
|
|
//
|
|
// The original license of DCEF3 still applies to CEF4Delphi.
|
|
//
|
|
// For more information about CEF4Delphi visit :
|
|
// https://www.briskbard.com/index.php?lang=en&pageid=cef
|
|
//
|
|
// Copyright © 2023 Salvador Diaz Fau. All rights reserved.
|
|
//
|
|
// ************************************************************************
|
|
// ************ vvvv Original license and comments below vvvv *************
|
|
// ************************************************************************
|
|
(*
|
|
* Delphi Chromium Embedded 3
|
|
*
|
|
* Usage allowed under the restrictions of the Lesser GNU General Public License
|
|
* or alternatively the restrictions of the Mozilla Public License 1.1
|
|
*
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
|
|
* the specific language governing rights and limitations under the License.
|
|
*
|
|
* Unit owner : Henri Gourvest <hgourvest@gmail.com>
|
|
* Web site : http://www.progdigy.com
|
|
* Repository : http://code.google.com/p/delphichromiumembedded/
|
|
* Group : http://groups.google.com/group/delphichromiumembedded
|
|
*
|
|
* Embarcadero Technologies, Inc is not permitted to use or redistribute
|
|
* this source code without explicit permission.
|
|
*
|
|
*)
|
|
|
|
unit uCEFBrowserViewComponent;
|
|
|
|
{$IFDEF FPC}
|
|
{$MODE OBJFPC}{$H+}
|
|
{$ENDIF}
|
|
|
|
{$I cef.inc}
|
|
|
|
{$IFNDEF TARGET_64BITS}{$ALIGN ON}{$ENDIF}
|
|
{$MINENUMSIZE 4}
|
|
|
|
interface
|
|
|
|
uses
|
|
{$IFDEF DELPHI16_UP}
|
|
{$IFDEF MSWINDOWS}WinApi.Windows,{$ENDIF} System.Classes,
|
|
{$ELSE}
|
|
{$IFDEF MSWINDOWS}Windows,{$ENDIF} Classes,
|
|
{$IFDEF FPC}
|
|
LCLProc, LCLType, LCLIntf, LResources, InterfaceBase,
|
|
{$ENDIF}
|
|
{$ENDIF}
|
|
uCEFTypes, uCEFInterfaces, uCEFConstants, uCEFViewsFrameworkEvents, uCEFViewComponent;
|
|
|
|
type
|
|
{$IFNDEF FPC}{$IFDEF DELPHI16_UP}[ComponentPlatformsAttribute(pfidWindows or pfidOSX or pfidLinux)]{$ENDIF}{$ENDIF}
|
|
TCEFBrowserViewComponent = class(TCEFViewComponent, ICefBrowserViewDelegateEvents)
|
|
protected
|
|
FBrowserView : ICefBrowserView;
|
|
FBrowserViewDlg : ICefBrowserViewDelegate;
|
|
|
|
// ICefBrowserViewDelegateEvents
|
|
FOnBrowserCreated : TOnBrowserCreatedEvent;
|
|
FOnBrowserDestroyed : TOnBrowserDestroyedEvent;
|
|
FOnGetDelegateForPopupBrowserView : TOnGetDelegateForPopupBrowserViewEvent;
|
|
FOnPopupBrowserViewCreated : TOnPopupBrowserViewCreatedEvent;
|
|
FOnGetChromeToolbarType : TOnGetChromeToolbarTypeEvent;
|
|
|
|
procedure DestroyView; override;
|
|
procedure Initialize; override;
|
|
|
|
function GetInitialized : boolean; override;
|
|
function GetAsView : ICefView; override;
|
|
function GetAsBrowserView : ICefBrowserView; override;
|
|
function GetBrowser : ICefBrowser;
|
|
|
|
// ICefBrowserViewDelegateEvents
|
|
procedure doOnBrowserCreated(const browser_view: ICefBrowserView; const browser: ICefBrowser);
|
|
procedure doOnBrowserDestroyed(const browser_view: ICefBrowserView; const browser: ICefBrowser);
|
|
procedure doOnGetDelegateForPopupBrowserView(const browser_view: ICefBrowserView; const settings: TCefBrowserSettings; const client: ICefClient; is_devtools: boolean; var aResult : ICefBrowserViewDelegate);
|
|
procedure doOnPopupBrowserViewCreated(const browser_view, popup_browser_view: ICefBrowserView; is_devtools: boolean; var aResult : boolean);
|
|
procedure doOnGetChromeToolbarType(var aChromeToolbarType: TCefChromeToolbarType);
|
|
|
|
public
|
|
function CreateBrowserView(const client: ICefClient; const url: ustring; const settings: TCefBrowserSettings; const extra_info: ICefDictionaryValue; const request_context: ICefRequestContext): boolean;
|
|
function GetForBrowser(const browser: ICefBrowser): boolean;
|
|
procedure SetPreferAccelerators(prefer_accelerators: boolean);
|
|
|
|
property Browser : ICefBrowser read GetBrowser;
|
|
property BrowserView : ICefBrowserView read FBrowserView;
|
|
|
|
published
|
|
property OnBrowserCreated : TOnBrowserCreatedEvent read FOnBrowserCreated write FOnBrowserCreated;
|
|
property OnBrowserDestroyed : TOnBrowserDestroyedEvent read FOnBrowserDestroyed write FOnBrowserDestroyed;
|
|
property OnGetDelegateForPopupBrowserView : TOnGetDelegateForPopupBrowserViewEvent read FOnGetDelegateForPopupBrowserView write FOnGetDelegateForPopupBrowserView;
|
|
property OnPopupBrowserViewCreated : TOnPopupBrowserViewCreatedEvent read FOnPopupBrowserViewCreated write FOnPopupBrowserViewCreated;
|
|
property OnGetChromeToolbarType : TOnGetChromeToolbarTypeEvent read FOnGetChromeToolbarType write FOnGetChromeToolbarType;
|
|
end;
|
|
|
|
{$IFDEF FPC}
|
|
procedure Register;
|
|
{$ENDIF}
|
|
|
|
// *********************************************************
|
|
// ********************** ATTENTION ! **********************
|
|
// *********************************************************
|
|
// ** **
|
|
// ** MANY OF THE EVENTS IN CEF4DELPHI COMPONENTS LIKE **
|
|
// ** TCHROMIUM, TFMXCHROMIUM OR TCEFAPPLICATION ARE **
|
|
// ** EXECUTED IN A CEF THREAD BY DEFAULT. **
|
|
// ** **
|
|
// ** WINDOWS CONTROLS MUST BE CREATED AND DESTROYED IN **
|
|
// ** THE SAME THREAD TO AVOID ERRORS. **
|
|
// ** SOME OF THEM RECREATE THE HANDLERS IF THEY ARE **
|
|
// ** MODIFIED AND CAN CAUSE THE SAME ERRORS. **
|
|
// ** **
|
|
// ** DON'T CREATE, MODIFY OR DESTROY WINDOWS CONTROLS **
|
|
// ** INSIDE THE CEF4DELPHI EVENTS AND USE **
|
|
// ** SYNCHRONIZATION OBJECTS TO PROTECT VARIABLES AND **
|
|
// ** FIELDS IF THEY ARE ALSO USED IN THE MAIN THREAD. **
|
|
// ** **
|
|
// ** READ THIS FOR MORE INFORMATION : **
|
|
// ** https://www.briskbard.com/index.php?pageid=cef **
|
|
// ** **
|
|
// ** USE OUR FORUMS FOR MORE QUESTIONS : **
|
|
// ** https://www.briskbard.com/forum/ **
|
|
// ** **
|
|
// *********************************************************
|
|
// *********************************************************
|
|
|
|
implementation
|
|
|
|
uses
|
|
uCEFBrowserView, uCEFBrowserViewDelegate, uCEFMiscFunctions;
|
|
|
|
procedure TCEFBrowserViewComponent.Initialize;
|
|
begin
|
|
inherited Initialize;
|
|
|
|
FBrowserView := nil;
|
|
FBrowserViewDlg := nil;
|
|
FOnBrowserCreated := nil;
|
|
FOnBrowserDestroyed := nil;
|
|
FOnGetDelegateForPopupBrowserView := nil;
|
|
FOnPopupBrowserViewCreated := nil;
|
|
FOnGetChromeToolbarType := nil;
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.DestroyView;
|
|
begin
|
|
if (FBrowserViewDlg <> nil) then
|
|
begin
|
|
FBrowserViewDlg.DestroyOtherRefs;
|
|
FBrowserViewDlg := nil;
|
|
end;
|
|
|
|
FBrowserView := nil;
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.CreateBrowserView(const client : ICefClient;
|
|
const url : ustring;
|
|
const settings : TCefBrowserSettings;
|
|
const extra_info : ICefDictionaryValue;
|
|
const request_context : ICefRequestContext): boolean;
|
|
begin
|
|
Result := False;
|
|
|
|
if CefCurrentlyOn(TID_UI) and (client <> nil) then
|
|
begin
|
|
if (FBrowserViewDlg = nil) then
|
|
FBrowserViewDlg := TCustomBrowserViewDelegate.Create(self);
|
|
|
|
FBrowserView := TCefBrowserViewRef.CreateBrowserView(client, url, settings, extra_info, request_context, FBrowserViewDlg);
|
|
Result := (FBrowserView <> nil);
|
|
end;
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.GetForBrowser(const browser: ICefBrowser): boolean;
|
|
begin
|
|
Result := False;
|
|
|
|
if CefCurrentlyOn(TID_UI) and (browser <> nil) then
|
|
begin
|
|
FBrowserView := TCefBrowserViewRef.GetForBrowser(browser);
|
|
Result := (FBrowserView <> nil);
|
|
end;
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.GetInitialized : boolean;
|
|
begin
|
|
Result := (FBrowserView <> nil);
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.GetAsView : ICefView;
|
|
begin
|
|
Result := FBrowserView as ICefView;
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.GetAsBrowserView : ICefBrowserView;
|
|
begin
|
|
Result := FBrowserView;
|
|
end;
|
|
|
|
function TCEFBrowserViewComponent.GetBrowser : ICefBrowser;
|
|
begin
|
|
if Initialized then
|
|
Result := FBrowserView.GetBrowser
|
|
else
|
|
Result := nil;
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.SetPreferAccelerators(prefer_accelerators: boolean);
|
|
begin
|
|
if Initialized then FBrowserView.SetPreferAccelerators(prefer_accelerators);
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.doOnBrowserCreated(const browser_view : ICefBrowserView;
|
|
const browser : ICefBrowser);
|
|
begin
|
|
if assigned(FOnBrowserCreated) then
|
|
FOnBrowserCreated(self, browser_view, browser);
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.doOnBrowserDestroyed(const browser_view : ICefBrowserView;
|
|
const browser : ICefBrowser);
|
|
begin
|
|
if assigned(FOnBrowserDestroyed) then
|
|
FOnBrowserDestroyed(self, browser_view, browser);
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.doOnGetDelegateForPopupBrowserView(const browser_view : ICefBrowserView;
|
|
const settings : TCefBrowserSettings;
|
|
const client : ICefClient;
|
|
is_devtools : boolean;
|
|
var aResult : ICefBrowserViewDelegate);
|
|
begin
|
|
if assigned(FOnGetDelegateForPopupBrowserView) then
|
|
FOnGetDelegateForPopupBrowserView(self, browser_view, settings, client, is_devtools, aResult);
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.doOnPopupBrowserViewCreated(const browser_view : ICefBrowserView;
|
|
const popup_browser_view : ICefBrowserView;
|
|
is_devtools : boolean;
|
|
var aResult : boolean);
|
|
begin
|
|
if assigned(FOnPopupBrowserViewCreated) then
|
|
FOnPopupBrowserViewCreated(self, browser_view, popup_browser_view, is_devtools, aResult);
|
|
end;
|
|
|
|
procedure TCEFBrowserViewComponent.doOnGetChromeToolbarType(var aChromeToolbarType: TCefChromeToolbarType);
|
|
begin
|
|
if assigned(FOnGetChromeToolbarType) then
|
|
FOnGetChromeToolbarType(self, aChromeToolbarType);
|
|
end;
|
|
|
|
{$IFDEF FPC}
|
|
procedure Register;
|
|
begin
|
|
{$I res/tcefbrowserviewcomponent.lrs}
|
|
RegisterComponents('Chromium Views Framework', [TCEFBrowserViewComponent]);
|
|
end;
|
|
{$ENDIF}
|
|
|
|
end.
|