aardio 文档

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

全局对象 成员列表

wkeWebView

返回对象:webKitViewObject

web.kit 成员列表

web.kit.layeredWindow

webkit分层窗体

web.kit.layeredWindow()

返回对象:webKitViewObject

web.kit.layeredWindow(winform)

参数为窗口对象

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 格式