217 Star 1.8K Fork 408

GVPdotNET China / NanUI

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
浏览器功能.md 12.10 KB
一键复制 编辑 原始数据 按行查看 历史
林选臣 提交于 2023-10-22 02:41 . 📖 WinFormium 文档 v1.0

浏览器功能

概述

本文主要介绍如何使用 WinFormium 的窗体 Formium 类及其与浏览器功能相关内容。Formium 类中与窗体相关的内容将在《窗体功能》中介绍。

加载网页

您可以使用 Url 属性来指定需要加载的网页地址。在浏览器初始化之前,您可以在构造函数里指定 Url 属性,那么当浏览器加载完成之后将会自动加载指定的网页。如果浏览器加载完成后,修改 Url 属性会立即加载新的网页。

另外,Formium 提供了 Reload 方法来重新加载当前网页,您可以在需要的时候调用该方法来重新加载当前网页。该方法有一个可选的 ignoreCache 参数,如果设置为 true,则会忽略缓存重新加载网页。

导航

您可以使用 GoBackGoForward 方法来实现浏览器的前进和后退功能。在调用这两个方法之前,您可以先判断 CanGoBackCanGoForward 属性的值是否为 true,如果为 true,则可以调用 GoBackGoForward 方法。

调试工具

您可以使用 Formium 类的 ShowDevTools 方法来显示浏览器的调试工具。使用 CloseDevTools 方法来隐藏调试工具。使用 HasDevTools 属性来判断调试工具是否已经显示。

执行 JavaScript 代码

您可以使用 ExecuteJavaScript 方法来执行 JavaScript 代码。也可以使用 EvaluateJavaScript 方法来执行 JavaScript 代码并返回执行结果。

有关在 WinFormium 中执行 JavaScript 的更多信息,请参阅 JavaScript 章节的相关介绍。

网页标题

您可以使用 UsePageTitle 属性来指定是否使用网页标题来设置窗体标题。如果设置为 true,则会使用网页标题来设置窗体标题。如果设置为 false,则会使用默认窗体标题来设置窗体标题。

API 参考

属性

通用属性

属性名 描述 类型 默认值
CanGoBack 获取一个值,该值指示浏览器是否可以向后导航。 bool false
CanGoForward 获取一个值,该值指示浏览器是否可以向前导航。 bool false
ChromiumEnvironment 获取当前浏览器的 Chromium 环境。 ChromiumEnvironment
HasDevTools 获取一个值,该值指示浏览器的调试工具是否已经显示。 bool false
IsLoading 获取一个值,该值指示浏览器是否正在加载网页。 bool false
Url 获取或设置当前浏览器加载的网页地址。 string "formium:blank"
UsePageTitle 获取或设置一个值,该值指示是否使用网页标题来设置窗体标题。 bool true

浏览器客户端接口属性

属性名 描述 类型
AudioHandler 获取或设置浏览器的音频处理程序。 WinFormium.AudioHandler
ContextMenuHandler 获取或设置浏览器的上下文菜单处理程序。 WinFormium.ContextMenuHandler
DialogHandler 获取或设置浏览器的对话框处理程序。 WinFormium.DialogHandler
DisplayHandler 获取或设置浏览器的显示处理程序。 WinFormium.DisplayHandler
DownloadHandler 获取或设置浏览器的下载处理程序。 WinFormium.DownloadHandler
DragHandler 获取或设置浏览器的拖放处理程序。 WinFormium.DragHandler
FindHandler 获取或设置浏览器的查找处理程序。 WinFormium.FindHandler
FocusHandler 获取或设置浏览器的焦点处理程序。 WinFormium.FocusHandler
FrameHandler 获取或设置浏览器的框架处理程序。 WinFormium.FrameHandler
JsDialogHandler 获取或设置浏览器的 JavaScript 对话框处理程序。 WinFormium.JsDialogHandler
KeyboardHandler 获取或设置浏览器的键盘处理程序。 WinFormium.KeyboardHandler
LifeSpanHandler 获取或设置浏览器的生命周期处理程序。 WinFormium.LifeSpanHandler
LoadHandler 获取或设置浏览器的加载处理程序。 WinFormium.LoadHandler
PermissionHandler 获取或设置浏览器的权限处理程序。 WinFormium.PermissionHandler
RenderHandler 获取或设置浏览器的渲染处理程序。 WinFormium.RenderHandler
RequestHandler 获取或设置浏览器的请求处理程序。 WinFormium.RequestHandler

方法

方法名 描述 返回值
BeginRegisterJavaScriptObject(CefFrame) 开始注册 JavaScript 对象。 JavaScriptObjectRegisterHandle
RegisterJavaScriptObject(JavaScriptObjectRegisterHandle,string, JavaScriptObject) 注册 JavaScript 对象。 bool
RegisterJavaScriptObject(JavaScriptObjectRegisterHandle,string, JavaScriptObjectWrapper) 注册 JavaScript 对象。 bool
EndRegisterJavaScriptObject(JavaScriptObjectRegisterHandle) 结束注册 JavaScript 对象。 void
EvaluateJavaScript(string,string,int) 执行 JavaScript 代码并返回执行结果。 Task
EvaluateJavaScript(CefFrame,string,string,int) 执行 JavaScript 代码并返回执行结果。 Task
ExecuteJavaScript(string,string,int) 执行 JavaScript 代码。 void
ExecuteJavaScript(CefFrame,string,string,int) 执行 JavaScript 代码。 void
GoBack() 导航到上一个网页。 void
GoForward() 导航到下一个网页。 void
ShowDevTools() 显示浏览器的调试工具。 void
CloseDevTools() 隐藏浏览器的调试工具。 void
Reload(bool) 重新加载当前网页。 void
PostBrowserJavaScriptMessage(string,JavaScriptValue) 向当前浏览器发送 JavaScript 消息。 void

事件

事件名 描述 参数
BeforeBrowse 在浏览器导航到新网页之前发生。 BeforeBrowseEventArgs
BeforeDownload 在浏览器开始下载文件之前发生。 BeforeDownloadEventArgs
BeforeKeyEvent 在浏览器接收到键盘事件之前发生。 BeforeKeyEventEventArgs
BrowserCreated 在浏览器创建之后发生。 BrowserCreatedEventArgs
CanDownload 在浏览器开始下载文件之前发生。 CanDownloadEventArgs
ConsoleMessage 在浏览器控制台输出消息时发生。 ConsoleMessageEventArgs
CursorChange 在浏览器的光标发生变化时发生。 CursorChangeEventArgs
DocumentAvailable 在浏览器加载网页文档之后发生。 DocumentAvailableEventArgs
DownloadUpdated 在浏览器下载文件时发生。 DownloadUpdatedEventArgs
FaviconUrlChange 在浏览器的网页图标发生变化时发生。 FaviconUrlChangeEventArgs
FramePageAddressChange 在浏览器的网页地址发生变化时发生。 FramePageAddressChangeEventArgs
FramePageLoadEnd 在浏览器的网页加载完成之后发生。 FramePageLoadEndEventArgs
FramePageLoadError 在浏览器的网页加载失败时发生。 FramePageLoadErrorEventArgs
FramePageLoadStart 在浏览器的网页开始加载之后发生。 FramePageLoadStartEventArgs
FullscreenModeChange 在浏览器的全屏模式发生变化时发生。 FullscreenModeChangeEventArgs
GetAuthCredentials 在浏览器需要用户输入凭据时发生。 GetAuthCredentialsEventArgs
KeyEvent 在浏览器接收到键盘事件时发生。 KeyEventArgs
MediaAccessChange 在浏览器的媒体访问权限发生变化时发生。 MediaAccessChangeEventArgs
OpenUrlFromTab 在浏览器需要打开新网页时发生。 OpenUrlFromTabEventArgs
PageAddressChange 在浏览器的网页地址发生变化时发生。 PageAddressChangeEventArgs
PageLoadEnd 在浏览器的网页加载完成之后发生。 PageLoadEndEventArgs
PageLoadError 在浏览器的网页加载失败时发生。 PageLoadErrorEventArgs
PageLoadStart 在浏览器的网页开始加载之后发生。 PageLoadStartEventArgs
PageLoadingProgressChange 在浏览器的网页加载进度发生变化时发生。 PageLoadingProgressChangeEventArgs
PageLoadingStateChange 在浏览器的网页加载状态发生变化时发生。 PageLoadingStateChangeEventArgs
PageTitleChange 在浏览器的网页标题发生变化时发生。 PageTitleChangeEventArgs
RenderProcessCrashed 在浏览器的渲染进程崩溃时发生。 RenderProcessCrashedEventArgs
SetFocus 在浏览器获得焦点时发生。 SetFocusEventArgs
StatusMessageChange 在浏览器的状态消息发生变化时发生。 StatusMessageChangeEventArgs
TakeFocus 在浏览器失去焦点时发生。 TakeFocusEventArgs
Tooltip 在浏览器的工具提示发生变化时发生。 TooltipEventArgs

另请参阅

C#
1
https://gitee.com/dotnetchina/NanUI.git
git@gitee.com:dotnetchina/NanUI.git
dotnetchina
NanUI
NanUI
master

搜索帮助