aardio 文档

web.kit.view 库模块帮助文档

全局对象 成员列表 #

wkeWebView #

返回对象:webKitViewObject

web.kit 成员列表 #

web.kit.view #

webkit视图

web.kit.view() #

创建WebKit视图,
如果不指定参数视图不负责创建显示窗口,
如果在参数中直接指定一个窗口对象,则创建默认的显示窗口,
控件创建的窗口句柄可通过hWkeWindow属性获取

返回对象:webKitViewObject

webKitViewObject 成员列表 #

webKitViewObject._form #

浏览器宿主窗口

返回对象:staticObject

webKitViewObject.addDirtyArea(x,y,w,h) #

设置无效区域

webKitViewObject.attach #

webKitViewObject.attach(  
    function(event){  
        io.print("点击坐标", event.screenX,event.screenY )  
        io.print("触发节点", event.srcElement.innerText )  
    }  
    ,"onclick",ele/*也可输入getEle()所需参数,省略表示doc*/   
)

webKitViewObject.attachAll #

webKitViewObject.attachAll(    
    /* html节点ID = 事件触发函数表 */  
    caption_button_min = {  
        onclick = function(event){  
            wb._form.hitmin();    
        }   
    }  
)

webKitViewObject.canGoBack() #

能否后退

webKitViewObject.canGoForward() #

能否前进

webKitViewObject.click(控件名字,随机延时最小值,延时最大值,框架名) #

模拟点击控件,
第一个参数也可以是ele对象,
随机延时值为可选参数,默认为1,500.
框架名为可选参数

webKitViewObject.contextMenuEvent(x,y,flags) #

转发右键菜单事件到网页
x,y 参数为相对于窗口左上角的坐标值,

flags 参数为_WKE_前缀常量,可省略,支持的选项如下
_WKE_CONTROL 表示按下Ctrl键_WKE_SHIFT 表示按下Shift键
_WKE_LBUTTON 表示按下鼠标左键
_WKE_MBUTTON 表示按下鼠标左键
_WKE_RBUTTON 表示按下鼠标右键
多个选项以 | 连接
不指定则默认为_WKE_RBUTTON

webKitViewObject.cookie #

返回网页cookie,文本

webKitViewObject.cookieClear() #

清空cookie

webKitViewObject.cookieClearSession() #

清空会话cookie

webKitViewObject.cookieData() #

返回所有cookie,返回值为fsys.cookies对象

返回对象:fsyscookiesObject

webKitViewObject.cookieEnabled #

是否允许使用cookie

webKitViewObject.cookieReload() #

自文件重新载入cookie

webKitViewObject.cookieSave() #

保存cookie

webKitViewObject.cookieSet() #

设置cookie,
参数可以是单个cookie的字段键值对组成的表,
也可以是符合HTTP响应头中设置Cookie格式相同的字符串
也可以指定fsys.cookies对象
了解cookie格式的细节,请查看fsys.cookies库

webKitViewObject.copy() #

复制

webKitViewObject.cut() #

剪切

webKitViewObject.delete() #

删除

webKitViewObject.destroy() #

销毁对象

webKitViewObject.dispatchEvent("字符串参数","click") #

触发事件

webKitViewObject.doScript(js代码) #

执行JS脚本

webKitViewObject.document #

Javascript网页文档对象
document.

webKitViewObject.enumCookie #

webKitViewObject.enumCookie(  
    function(sData,pData){  
        /*pData为cookie指针,sData为Cookie文本*/  
    }  
)

webKitViewObject.eval(JS表达式) #

计算JS表达式并返回值

webKitViewObject.external #

webKitViewObject.external = {  
    /*external的成员函数可在JS中调用*/  
};

webKitViewObject.flash #

获取默认的或 name 属性为 plugin 的 Flash NPAPI 插件对象
直接打开 *.swf 文件时会自动创建此对象

返回对象:webNpPluginFlashObject

webKitViewObject.focus() #

设置焦点

webKitViewObject.getContentsHeight() #

文档高度

webKitViewObject.getContentsWidth() #

文档宽度

webKitViewObject.getForm() #

返回该视图所在窗体对象

返回对象:winform

webKitViewObject.getForm(false) #

返回该视图所在窗口或控件对象

webKitViewObject.getHeight() #

视图高度

webKitViewObject.getWidth() #

视图宽度

webKitViewObject.go("字符串参数") #

打开网址
如果导入 web.npPlugin.flash 则支持输入 swf 文件网址

webKitViewObject.goBack() #

后退

webKitViewObject.goForward() #

前进

webKitViewObject.hWkeWindow #

如果在创建web.kit.view对象时指定了父窗口参数,并由WKE创建控件显示窗口
此属性返回WKE创建的窗口句柄

webKitViewObject.html #

webKitViewObject.html = /**  
<!doctype html>  
<html>  
<head>  
    <style type="text/css">  
    html,body{ height:100%; margin:0; }   
    </style>  
    <script type="text/javascript"></script>  
</head>  
<body>  
    <div id="header"></div>  
    <div id="container">   
        <div class="lside"> </div>   
        <div class="rside"> </div>    
    </div>  
</body>  
</html>  
**/

webKitViewObject.isAwake() #

是否运行

webKitViewObject.isDirty() #

是否需要重绘

webKitViewObject.isDocumentReady() #

文档对象是否准备就绪

webKitViewObject.isLoadComplete() #

是否加载完成
即isLoaded或isLoadFailed函数返回true

webKitViewObject.isLoadFailed() #

是否加载失败

webKitViewObject.isLoaded() #

是否加载成功

webKitViewObject.jQuery("字符串参数") #

jQuery选择器,并可自动载入jQuery库
n首次调用按需加载jQuery v1.9:
"/res/js/jQuery/jQuery.min.js"
失败则通过网络CDN服务器下载jquery-1.9.0.min.js

webKitViewObject.jQuery() #

无参数时返回jQuery类对象
首次调用按需加载 jQuery v1.9:
"/res/js/jQuery/jQuery.min.js"
失败则通过网络CDN服务器下载jquery-1.9.0.min.js

返回对象:jQueryObject

webKitViewObject.keyDown(vkCode,flags,sysKey) #

转发按键释放事件到网页

vkCode 参数指定虚拟键码,请参考标准库key.VK

flags 参数可用指定一个或多个以下选项:
_WKE_REPEAT表示重复按键,
_WKE_EXTENDED表示扩展键,
多个选项以 | 连接

sysKey 参数指定是否同时按下ALT键,

webKitViewObject.keyPress(charCode,flags,sysKey) #

转发WM_CHAR事件到网页

charCode 参数指定字符代码,

flags 参数可用指定一个或多个以下选项:
_WKE_REPEAT表示重复按键,
_WKE_EXTENDED表示扩展键,
多个选项以 | 连接

sysKey 参数指定是否同时按下ALT键,

webKitViewObject.keyUp(vkCode,flags,sysKey) #

转发按键释放事件到网页

vkCode 参数指定虚拟键码,请参考标准库key.VK

flags 参数可用指定一个或多个以下选项:
_WKE_REPEAT表示重复按键,
_WKE_EXTENDED表示扩展键,
多个选项以 | 连接

sysKey 参数指定是否同时按下ALT键,

webKitViewObject.load( filename) #

加载文件

webKitViewObject.loadScript("js地址","字符串参数","utf-8") #

动态加载js文件\N可选用第三个参数指定文件编码

webKitViewObject.location #

当前网址

webKitViewObject.mediaVolume #

音量,范微0.0到1.0

webKitViewObject.mouseEvent(message,x,y,flags) #

转发鼠标事件到网页
message为_WM_前缀的窗口鼠标消息常量
x,y 参数为相对于窗口左上角的坐标值,

flags 参数为_WKE_前缀常量,可省略,支持的选项如下
_WKE_CONTROL 表示按下Ctrl键_WKE_SHIFT 表示按下Shift键
_WKE_LBUTTON 表示按下鼠标左键
_WKE_MBUTTON 表示按下鼠标左键
_WKE_RBUTTON 表示按下鼠标右键
多个选项以 | 连接
不指定则默认为_WKE_LBUTTON

webKitViewObject.mouseWheel(x,y,delta,flags) #

转发滚轮事件到网页
x,y 参数为相对于屏幕左上角的坐标值,
delta为120的倍数,负数向下滚动,正数向上滚动,

flags 参数为_WKE_前缀常量,可省略,支持的选项如下
_WKE_CONTROL 表示按下Ctrl键_WKE_SHIFT 表示按下Shift键
_WKE_LBUTTON 表示按下鼠标左键
_WKE_MBUTTON 表示按下鼠标左键
_WKE_RBUTTON 表示按下鼠标右键
多个选项以 | 连接
不指定则默认为_WKE_MBUTTON

webKitViewObject.onAlertBox #

webKitViewObject.onAlertBox = function(str){
    /*alert对话框触发此事件,返回true不显示默认对话框*/     
    return true;   
}

webKitViewObject.onConfirmBox #

webKitViewObject.onConfirmBox = function(str){
    /*确认对话框触发此事件,  
定义此事件后不再显示确认对话框,可在这里修改返回值*/ 
   return result; 
}

webKitViewObject.onDocumentReady #

webKitViewObject.onDocumentReady = function(url,mainFrameJSState,frameJSState){
    if( mainFrameJSState == frameJSState ){
        /*主框架加载完成*/
    }
}

webKitViewObject.onNavigation #

webKitViewObject.onNavigation = function(url,navigationType){ 
    if( navigationType == _WKE_NAVIGATION_TYPE ){

    }
    return true;
}

webKitViewObject.onPromptBox #

webKitViewObject.onPromptBox = function(title, default){
    /*输入对话框,可选返回输入的字符串  
title为标题,default为默认显示在输入框的文本*/
    return;
}

webKitViewObject.onTitleChanged #

webKitViewObject.onTitleChanged = function(title){ 
    owner.getForm().text = title;
}

webKitViewObject.onURLChanged #

webKitViewObject.onURLChanged = function(url){ 
    if(#url) owner.getForm().msgbox( url )
}

webKitViewObject.paint(bits,pitch) #

绘图,参数@1为位图像素数组指针
关于这个函数的用法请参考web.kit.gdiRender

webKitViewObject.paste() #

复制

webKitViewObject.plugin #

获取默认的或 name 属性为 plugin 的 NPAPI 插件对象

webKitViewObject.post(网址,POST数据) #

POST提交数据

webKitViewObject.print(hdc,scale) #

用于GDI打印输出,hdc为打印机设备DC,
scale指定缩放比例,正数为缩放文档,负数按输出页面缩放
例如-0.5为缩放至页面的50%

webKitViewObject.queryEles #

搜索节点对象,该函数返回的是一个数组,
但可以通过调用数组的成员函数批量调用节点的同名成员函数,支持click函数,
即使找不到节点,此函数也会返回一个空数组,

webKitViewObject.queryEles() #

返回对象:eleObject

webKitViewObject.queryEles(CSS选择器,查询参数表,超时值) #

搜索节点对象,该函数返回的是一个数组,
但可以通过调用数组的成员函数批量调用节点的同名成员函数,支持click函数

参数@1指定一个表对象,
该参数表可包含一个或多个键值,用于匹配节点的属性值,
属性值使用 string.cmpMatch函数进行比对,
等价于调用string.cmp函数进行忽略大小写的比较,
并且在失败后调用 string.match函数使用模式匹配语法进行比较。

注意在匹配节点属性时有几个例外:
tagName,id,name属性如果匹配值不含标点则使用忽略大小写的完全比对(禁用模式匹配和部分匹配)

可选使用参数@2指定获取网页文档对象的超时值,单位毫秒,此参数一般不需要指定

webKitViewObject.querySelector("CSS选择器") #

查询并返回节点

webKitViewObject.querySelector() #

返回对象:eleObject

webKitViewObject.querySelectorAll("CSS选择器") #

查询并返回节点集合,length属性获取节点个数

webKitViewObject.querySelectorAll() #

返回对象:eleObject

webKitViewObject.reload() #

重新载入

webKitViewObject.resize(w,h) #

调整大小

webKitViewObject.script #

Javascript全局对象

返回对象:jsGlobalObject

webKitViewObject.select("控件名字",/*输入选项索引,或选项值、选项文本*/) #

查找下拉选框的指定选项,选中并返回选项节点
第一个参数也可以是ele对象

webKitViewObject.selectAll() #

全选

webKitViewObject.setDirty(dirty) #

设置是否需要重绘

webKitViewObject.setEditable(editable) #

设置编辑状态

webKitViewObject.setEle(控件名字,属性值,属性名) #

更新控件值,成节返回节点,失败返回null空值
第一个参数也可以是ele对象,
属性名,框架名为可选参数.
属性值可以是一个指定多个属性键值对的table对象

webKitViewObject.sleep() #

休眠

webKitViewObject.stopLoading() #

停止加载

webKitViewObject.translateUrl #

webKitViewObject.translateUrl = function(url){
    /*可在此函数中转换 go 函数传入的 URL 参数*/
    return url;
}

webKitViewObject.transparent #

背景是否透明
不透明则使用白色背景

webKitViewObject.unfocus() #

取消焦点

webKitViewObject.userAgent #

设置User Agent

webKitViewObject.wait #

该函数等待网页完全加载完成,
因为部份网页遇到问题可能部份内容无法完全加载,
建议大家尽可能使用等待部份加载的waitEle或waitDoc等函数替代

webKitViewObject.wait("网址",超时值) #

等待指定的网页加载完成,所有参数可选,
等待的网址支持模式语法,参数@2指定最大超时值,单位毫秒

webKitViewObject.waitDoc() #

等待文档对象准备就绪,并返回文档对象
document.

webKitViewObject.waitEle("ID或名称",,超时值) #

返回一个节点对象,除参数一以外,其他能数可选
第三个参数指定超时值(单位为毫秒)
参数@2必须为空

webKitViewObject.waitQueryEles #

函数等待queryEles()返回有效节点,
即使找不到节点,此函数也会返回一个空数组,
web窗体关闭或超时返回null空值

webKitViewObject.waitQueryEles() #

返回对象:eleObject

webKitViewObject.waitQueryEles(CSS选择器,查询参数表,超时值,时间间隔,节点完全加载) #

函数等待wb.queryEles()返回有效节点,
web窗体关闭或超时返回null空值

该函数返回的是一个数组,但可以通过调用数组的成员函数
批量调用节点的同名成员函数,支持click函数

参数@1指定一个表对象,
该参数表可包含一个或多个键值,用于匹配节点的属性值,
属性值使用 string.cmpMatch函数进行比对,
等价于调用string.cmp函数进行忽略大小写的比较。
并且在失败后调用 string.match函数使用模式匹配语法进行比较。

注意在匹配节点属性时有几个例外:
tagName,id,name属性如果匹配值不含标点则使用忽略大小写的完全比对(禁用模式匹配和部分匹配)

可选使用参数@2指定超时值,单位毫秒,,其他参数可选

webKitViewObject.wake() #

恢复运行

webKitViewObject.window #

Javascript全局对象

返回对象:jsGlobalObject

webKitViewObject.wndproc(hwnd,message,wParam,lParam) #

处理窗口消息
返回值为真表示不再需要后续默认消息处理

webKitViewObject.write(html) #

写入HTML,如果参数@1不是字符串、buffer、null 则自动转为字符串

webKitViewObject.zoomFactor #

缩放百分比
浮点数,1.0为实际大小

webNpPluginFlashObject 成员列表 #

webNpPluginFlashObject.Back() #

影片后退一帧并停止播放

webNpPluginFlashObject.CurrentFrame() #

当前帧索引,注意第一帧索引为0

webNpPluginFlashObject.Forward() #

影片后退一帧并停止播放

webNpPluginFlashObject.GetVariable("$version变量名") #

获取FLASH变量

webNpPluginFlashObject.GotoFrame(索引) #

将影片跳转到指定的帧并停止播放.
必须首先调用percentLoaded()函数保证影片完全加载

webNpPluginFlashObject.IsPlaying() #

是否正在播放动画

webNpPluginFlashObject.LoadMovie(layer,url) #

将由url指定的影片载入到由layer指定的层上
如果url指定了一个资源文件路径,使用临时文件加载,并设置embedMovie属性为 true

webNpPluginFlashObject.Pan(x,y,mode) #

将一个放大过的影片平移由x和y指定的距离,x和y均为相对值,
mode默认值为1,按百分比计算,如果设为0则以像素计算

webNpPluginFlashObject.PercentLoaded() #

返回影片加载的百分比

webNpPluginFlashObject.Play() #

播放

webNpPluginFlashObject.Rewind() #

返回到影片的第一帧

webNpPluginFlashObject.SetVariable("变量名",值) #

设置FLASH变量

webNpPluginFlashObject.SetZoomRect(left,top,right,buttom) #

放大指定区域

webNpPluginFlashObject.Stop() #

暂停

webNpPluginFlashObject.TCallFrame(movieClip,frame_number) #

call指定帧上的action

webNpPluginFlashObject.TCallLabel(movieClip,label) #

call指定标签上的action

webNpPluginFlashObject.TCurrentFrame(movieClip) #

回传movieClip当前帧-1

webNpPluginFlashObject.TCurrentLabel(movieClip) #

回传movieClip当前标签

webNpPluginFlashObject.TGetProperty(movieClip,property) #

获取movieClip的指定属性

webNpPluginFlashObject.TGotoLabel(movieClip,label_name) #

movieClip跳转到指定标签

webNpPluginFlashObject.TPlay(movieClip) #

播放movieClip

webNpPluginFlashObject.TSetProperty(movieClip,property,number) #

设置movieClip的指定属性

webNpPluginFlashObject.TStopPlay(movieClip) #

停止movieClip的播放

webNpPluginFlashObject.TotalFrames() #

返回影片总帧数

webNpPluginFlashObject.Zoom(percent) #

改变动画大小

webNpPluginFlashObject.getAttribute(name) #

获取节点属性

webNpPluginFlashObject.setAttribute(name,value) #

设置节点属性,
相当于在HTML里写属性值

自动完成常量

_WKE_CONTROL=8
_WKE_EXTENDED=0x100
_WKE_LBUTTON=1
_WKE_MBUTTON=0x10
_WKE_NAVIGATION_TYPE_BACKFORWARD=2
_WKE_NAVIGATION_TYPE_FORMRESUBMITT=4
_WKE_NAVIGATION_TYPE_FORMSUBMITTE=1
_WKE_NAVIGATION_TYPE_LINKCLICK=0
_WKE_NAVIGATION_TYPE_OTHER=5
_WKE_NAVIGATION_TYPE_RELOAD=3
_WKE_RBUTTON=2
_WKE_REPEAT=0x4000
_WKE_SHIFT=4

Markdown 格式