本文主要介绍如何使用 WinFormium 的窗体 Formium
类及其与浏览器功能相关内容。Formium
类中与窗体相关的内容将在《窗体功能》中介绍。
您可以使用 Url
属性来指定需要加载的网页地址。在浏览器初始化之前,您可以在构造函数里指定 Url
属性,那么当浏览器加载完成之后将会自动加载指定的网页。如果浏览器加载完成后,修改 Url
属性会立即加载新的网页。
另外,Formium
提供了 Reload
方法来重新加载当前网页,您可以在需要的时候调用该方法来重新加载当前网页。该方法有一个可选的 ignoreCache
参数,如果设置为 true
,则会忽略缓存重新加载网页。
您可以使用 GoBack
和 GoForward
方法来实现浏览器的前进和后退功能。在调用这两个方法之前,您可以先判断 CanGoBack
和 CanGoForward
属性的值是否为 true
,如果为 true
,则可以调用 GoBack
和 GoForward
方法。
您可以使用 Formium
类的 ShowDevTools
方法来显示浏览器的调试工具。使用 CloseDevTools
方法来隐藏调试工具。使用 HasDevTools
属性来判断调试工具是否已经显示。
您可以使用 ExecuteJavaScript
方法来执行 JavaScript 代码。也可以使用 EvaluateJavaScript
方法来执行 JavaScript 代码并返回执行结果。
有关在 WinFormium 中执行 JavaScript 的更多信息,请参阅 JavaScript 章节的相关介绍。
您可以使用 UsePageTitle
属性来指定是否使用网页标题来设置窗体标题。如果设置为 true
,则会使用网页标题来设置窗体标题。如果设置为 false
,则会使用默认窗体标题来设置窗体标题。
通用属性
属性名 | 描述 | 类型 | 默认值 |
---|---|---|---|
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 |
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。