3 - ONE开发参考

枚举
    * CallValueId - 事件代理传送标识
    * ContextMenuItemId - 右键菜单选项标识
    * EngineId - 引擎核心标识
    * LanguageId - 语言标识
    * NavigationStateFlag - 浏览状态标识

 

OneWebNavigator类

 

- 属性

• ONE.UrlLogEntryNode[] BackwardLogs { get; } // 比当前浏览记录旧的记录数组
• ONE.UrlLogEntryNode[] ForwardLogs { get; } //  比当前浏览记录新的记录数组
• bool EnableLibraryValidation { set; get; } // 选定引擎后，浏览器控件进入运行时后，是否在加载时验证库文件完整性(只适用gecko和webkit) 。
• ONE.EngineId Engine { set; get; } // 引擎核心标识，CreateNavigator方法执行后不能修改。
• bool IsAlive { get; } // 浏览器是否处于活动的状态
• bool IsNavigationBusy { get; } // 浏览器是否处于繁忙状态
• string NavigationTitle { get; } // 当前网页的标题
• System.Uri NavigationUrl { get; } // 当前网页的网址
• System.Windows.Forms.BorderStyle PanelStyle { set; get; } // 边框的式样，可选值：None 无边框；FixedSingle 单行边框；Fixed3D 三维边框
• ONE.LanguageId UILanguage { set; get; } // 界面语言标识，可选值：auto 自动；en：英文；cn：简体中文；zh：繁体中文。此值在运行时不能修改。
• string Version { get; } // OneWebNavigator的版本编号，格式为：年年月月日日时时分分，如091209.1838表示2009年12月9日18时38分发布的版本（UTC+08:00）。

- 事件

• event ONE.PolyCall One_AfterContextMenuItemSelected // 鼠标右键选中菜单时发生，目前此事件用于响应打开选中连接的方式。
• event ONE.PolyCall One_AfterClickMouse // 当鼠标按键在浏览器的矩形范围内按下鼠标后发生。
• event ONE.SoloCall One_AfterPressKey // 当浏览器获取输入焦点时，键盘按下按键再弹起时发生。
• static event ONE.PolyCall One_BeforePopupNavigator // 网页脚本申请一个弹出的浏览器窗口之前发生，这个事件会先创建一个浏览器窗口（不可见），然后获取其网址（不加载，也就是不发生 BeforeLoadUrl事件），然后释放这个傀儡浏览器窗口，把网址转告开发者决定下一步。
• event ONE.SoloCancelCall One_BeforeLoadUrl // 在加载当前的网页网址之前发生，你可以在这里过滤不需要的协议和网址。
• event ONE.PolyCall One_BeforeAlertMessage // 当浏览器的网页脚本使用window.alert方法时发生。
• event ONE.PolyConfirmCall One_BeforeConfirmMessage // 当浏览器的网页脚本使用window.confirm方法时发生
• event ONE.SoloCall One_BeforeOpenWindow // 在网页打开新窗口之前发生，这种情况属于用户的操作引起。
• event ONE.PolyCall One_BeforePopupUrl // 在网页弹出新的网址之前发生，这种情况属于非用户的操作引起。
• event ONE.SoloCall One_NotifyStartLoadingUrl // 在加载当前的网页网址时发生，表示加载进行中。在一个网页的加载地址过程中，下一个对应的事件为 One_NotifyCompleteLoadingUrl，前一个对应的事件为One_BeforeLoadUrl。
• event ONE.VoidCall One_NotifyCompleteLoadingUrl // 在完全加载当前的网页网址完毕时发生
• event ONE.SoloCall One_NotifyNavigationStatusTextChanged // 在浏览器的状态栏文本发生变化时通知
• event ONE.SoloCall One_NotifyNavigationStateChanged // 在浏览器的状态改变时通知，目前用于切换浏览器是否可以向前跳转、向后跳转和查询浏览历史状态。
• event ONE.SoloCall One_NotifyNavigationTitleChanged // 在浏览器的网页标题发生变化时通知
• event ONE.PolyCall One_NotifyNavigationUrlChanged // 当浏览器的网页网址变化时通知

- 方法

• static bool ValidateEngineLibrary (ONE.EngineId engine) // 验证当前引擎库文件的完整性，返回false时不能正常使用。
• OneWebNavigator() // 构造函数
• void StopNavigating() // 停止当前正在进行的浏览加载，如果NotifyCompleteLoadingUrl事件已经发生(页面已经加载完毕)，则无效果。
• bool CreateNavigator() // 创建浏览器。在设计时，浏览器引擎的核心部分并不存在，设计者所修改的只是浏览器的容器的矩形大小和外表。OneWebNavigator首次使用前必须执行一次CreateNavigator方法创建，释放时则调用DestroyNavigator方法。返回值为true表示创建成功，返回值为 false表示创建失败（此时需留意信息窗口提示或exception）
• void DestroyNavigator() // 释放浏览器引擎核心的资源，CreateNavigator和DestroyNavigator应该成对使用。
• ONE.NavigationState[] GoBackward() // 往访问时间旧的方向打开浏览器的网址
• ONE.NavigationState[] GoForward() // 往访问时间新的方向打开浏览器的网址
• void GoToLogCursor(ONE.UrlLogEntryNode node) // 跳转到node所在的记录
• void Navigate(string text) // 浏览网址
• void Reload(bool isCompletely) // 刷新页面，isCompletely为true时完全刷新（跳过cache），isCompletely为false时则由引擎自身对比内容记录时间自动刷新。
• bool SearchTextUpDown(string text, bool isMatchWord, bool isMatchCase, bool isForward) // 在当前网页上下搜索文本，isMatchWord表示是否匹配单词，isMatchCase表示是否匹配字母大小写，isForward表示是否向下搜索， 返回值为true表示找到结果。

其他类

• CallValue 事件代理数据包装类
• NavigationState 浏览状态包装类
• UrlLogEntry 网址记录类
      * System.DateTime AccessDateTime // 访问时间，创建新的实例时AccessDateTime=System.DateTime.Now
      * string Title // 网页标题
      * string Url // 网址
•  UrlLogEntryNode 网址记录节点类（用于浏览历史记录链）
      * ONE.UrlLogEntryNode Backward // 前一个（旧的）UrlLogEntry记录节点
      * ONE.UrlLogEntryNode Forward // 后一个（新的）UrlLogEntry记录节点
      * ONE.UrlLogEntry Value // 当前的数据