DHTML Scriptlets 容器对象参考手册

    DHTML小脚本容器对象参考手册,包含DHTML小脚本(Scriptlet)基准文档。在这里可以了解如下内容:1、窗口对象扩展:这些扩展内容是在编写小脚本时可以使用的属性与方法。 2、在小脚本容器对象中可用的属性与事件:在运行期间可以把它们与小脚本实例一起使用。 

DHTML DHTML小脚本窗口对象扩展参考

说明
    在以一种DHTML小脚本创建脚本时,可以使用动态HTML(DHTML)对象模型的下述专门扩展内容。所有扩展可在DHTML window.external对象中找到。
属性
    frozen , scrollbar, selectableContent, version
方法
    bubbleEvent , raiseEvent, setContextMenu


bubbleEvent方法
    按照标准事件,从一个DHTML小脚本向宿主应用程序发送事件通知。
适用于
    DHTML window.external对象
语法
    window.external.bubbleEvent ()
说明
    使用这种方法把一个标准DHTML事件(例如onbuttonclick、onmousemove、onkeypress)从一个DHTML小脚本传递到宿主应用程序。
frozen属性
    表示小脚本容器对象是否准备好处理来自DHTML小脚本的事件。
适用于
    DHTML window.external对象
语法
    boolean = window.external.frozen
说明
    这个属性是只读型的。当其为真时,事件不能被小脚本容器对象所接受,原因是这个容器尚未准备好。当其为假时,容器将接受事件通知。
raiseEvent方法
    把一个定制事件通知从一个DHTML小脚本传递给宿主应用程序。
适用于
    DHTML window.external对象
语法
    window.external.raiseEvent (eventName, eventObject)
参量
    eventName
    一个串,作为典型标识要传递的事件
    eventObject
    一种变式类型,典型情况包含一个引用,这个引用指向DHTML小脚本上触发事件的对象。
说明
    这个方法是小脚本容器对象的onscriptletevent事件的补充。使用这种方法把有关非标准事件的情况通知给宿主应用程序。
scrollbar属性
    规定小脚本容器对象是否让DHTML小脚本显示滚动条。
适用于
    DHTML Window.external对象
语法
    window.external.scrollbar = boolean
    -或者-
    ScriptContainer.scrollbar = boolean
说明
    这个属性可以在设计期间和在运行期间设置。作为默认,这个属性的值是假。如果把这个属性设置为真,则:
    纵向滚动条总出现在该小脚本容器对象中。如果DHTML小脚本的高度小于小脚本容器对象的窗口高度,则纵向滚动条关闭。
    如果这个小脚本的宽度大于小脚本容器对象的窗口宽度出现横向滚动条。
selectableContent属性
    规定用户是否可以选择DHTML小脚本的内容。
适用于
    DHTML Window.external对象
语法
    window.external.selectableContent = boolean
说明
    按照默认,这个属性的值是假。如果这个属性是真,用户可以在DHTML小脚本中选择文本或对象,并且在小脚本容器对象中显示出来,然后复制或拖动它们。如果这个属性是假,用户可以点击小脚本中的事件,但是可以不选择它们。
setContextMenu方法
    构造一个描述体菜单,并在用户右击小脚本容器对象中的DHTML小脚本时显示出来。
适用于
    DHTML window.external对象
语法
    window.external.setContextMenu(menuDefinition)
参量
    menuDefinition
    定义包含在描述体菜单中的命令文本和命令。一个一维阵列,在这个阵列中使用两个元素阵列,n和n + 1,定义菜单项:
    Element命令文本。快捷键定义为开始用“&”字符
    Element n + 1 在命令被选中时调用的方法。不能把参量传递给该方法。
注意:
    描述体菜单只能在由VBScript或JavaScript编写的脚本中定义,因为这两种语言建立的阵列可被setContextMenu方法访问。
举例
    下边的脚本定义一个描述体菜单,带有三个命令:

<script language="VBScript" for ="Menu" Event="onclick">
    
'define array
    dim menuItems(6'3 commands 
    'First menu item
    menuItems(0= "Display the &time" 'Command text
    menuItems(1= "SetTime"
    'Second menu item
    menuItems(2= "Display the &date"     'Command text   
    menuItems(3= "SetDate"
    'Third menu item
    menuItems(4= "Display the document t&itle" 'Command text
    menuItems(5= "SetTitle"
    'Assigns the menu to the scriptlet
    window.external.setContextMenu(MenuItems)
</script>


version属性
    返回版本和用于DHTML小脚本的小脚本容器对象平台。
适用于
    DHTML Window.external对象
语法
    version = window.external.version
说明
    这个属性是只读型的。版本返回到格式N.nnnn platform中。其中N是表示主版本号的整数;nnnn是任意个字符(空格除外),表示次版本号;platform是平台(win32、mac和alpha等)。下边是版本号的一个例子:
    1.0a win32
    可以使用version属性确定页面是作为一个DHTML小脚本来使用还是作为一个单独Web页面来使用。使用下边这样一个语句:
    contro1Mode = (typeof(window.external.version) == "string"
    如果在这个语句执行之后,contro1Mode的值是真,这个页面就作为一个DHTML小脚本来使用。否则,这个页面就作为一个独立页面来使用。
DHTML参考
说明
    小脚本容器对象用作一个应用程序中的宿主DHTML小脚本。它所提供的属性和事件都作为所有DHTML小脚本的标准扩展内容而随时可用。当人们在应用程序中用DHTML小脚本进行工作时,可以使用下述小脚本容器对象中的属性与事件。
属性
    scrollbar、event、readyState和url
事件
    onclick事件, ondblclick事件, onkeydown事件, onkeypress事件, onkeyup事件, onmousedown, onmousedown事件, onmousemove事件, onreadystatechange事件, onscriptletevent事件
EVENT属性
    提供从一个DHTML小脚本传递出来的有关标准DHTML事件的状态信息。
适用于
    Scriptlet Container对象
语法
    value = ScriptContainer.event.member
说明
    这个属性是只读型的。该event属性提供一种获取有关标准事件状态信息的方式。这些来自小脚本的标准事件是:onclick、ondblclick、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove和onmouseup。这个属性负责对DHTML event对象作出响应。
    要想获取状态信息,可以查询event属性成员的值。这些成员包括:altKey、ctrlKey、keyCode、offsetX、offsetY、shiftKey、srcElement和type等。下边脚本例子说明如何使用event属性获取有关标准事件的更多信息:
sub ScriptContainer1_onkeyup( )
    
MsgBox "The character typed was" & ScriptContainer1.event.keyCode
    
MsgBox "The Alt key state was" & ScriptContainer1.event.altkey
    
MsgBox "The Ctrl key state was" & ScriptContainer1.event.ctrlkey
    
MsgBox "The Shift key state was" & ScriptContainer1.event.shiftkey
    
MsgBox "The mouse was at" & offsetX & "" & offsetY
    
MsgBox "The affedcted control was" & ScriptContainer1.event.srcElement
    
MsgBox "The event was" & ScriptContainer1.event.type
End Sub

    关于event属性的信息,详见DHTML文档中的event对象。


ONCLICK事件
    在一个DHTML小脚本转发一个onclick事件时发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_onclick()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onclick">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    · DHTML小脚本包含onclick事件的处理程序
    · DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONDBLCLICK事件
    在一个DHTML小脚本转发一个ondblclick事件的时候发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_ondblClick()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="ondblClick">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    · DHTML小脚本包含ondblclick事件的处理程序
    · DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONKEYDOWN事件
    在一个DHTML小脚本转发一个onkeydown事件的时候发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_onkeydown()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeydown">
说明
    如果下述两个条件都是真,这个小脚本容器对象就接受这个事件:
    DHTML小脚本包含onkeydown事件的处理程序
    DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONKEYPRESS事件
    在一个DHTML小脚本转发一个onkeypress事件的时候发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_onkeypress()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeypress">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    DHTML小脚本包含onkeypress事件的处理程序 
    DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。 
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONKEYUP事件
    在一个DHTML小脚本转发一个onkeyup事件的时候发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_onkeyup()
JavaScript语法
    <SCRIPT LANGUAGE="javaScript" FOR="ScriptContainer" EVENT="onkeyup">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    · DHTML小脚本包含onkeyup事件的处理程序
    · DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONMOUSEDOWN, ONMOUSEUP事件
    在一个DHTML小脚本转发一个onmousedown 或 onmouseup事件时发送。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_ onmousedown()
    ScriptContainer_ onmouseup()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmousedown"> 
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmouseup">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    · DHTML小脚本包含onmousedown 或 onmouseup事件的处理程序
    · DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。
ONMOUSEMOVE事件
    发送这个事件,表示一个DHTML小脚本是否装载完毕。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_ onmousemove()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmousemove">
说明
    如果下述两个条件都是真,则这个小脚本容器对象就接受这个事件:
    · DHTML小脚本包含onmousemove事件的处理程序
    · DHTML小脚本处理程序调用bubbleEvent方法,把这个事件传递给宿主应用程序。
    可以借助于查询小脚本对象容器事件属性的办法获得有关这个事件的状态信息。


ONREADYSTATECHANGE事件
    发送这个事件,表示一个DHTML小脚本是否装载完毕。
适用于
    Scriptlet Container对象
Visual Basic语法
    ScriptContainer_ onreadystatechange()
JavaScript语法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onreadystatechange">
说明
    在一个DHTML小脚本装载过程中,这个事件激发多次。最后一次激发表示小脚本的HTML页面已经完全装载,因而它的脚本可以调用。为测试当前状态,要获取小脚本容器对象的readystate(就绪状态)属性的值。


ONSCRIPTLETEVENT事件
    通知小脚本容器对象:在一个DHTML小脚本中已经出现了一个客户事件。
适用于
    Scriptlet Container对象
语法
    ScriptContainer_ onscriptletevent(eventName, eventObject)
参量
    eventName
    一个串,典型情况是表示正在传递的事件
    eventObject
    一种变式类型,典型情况是到小脚本上一个对象的引用子。
注意:
    这两种参量的确切内容取决在小脚本对应的raiseEvent方法中传递的信息是什么。
说明
    这个事件是小脚本raiseEvent方法的一种补充。

READYSTATE属性
    返回寄宿在容器对象中一个DHTML小脚本装载状态的有关信息。
适用于
    Scriptlet Container对象
语法
    ScriptContainer.readyState = integer
说明
    这个属性是只读型的。只在运行期间使用。
    这个readyState属性返回1与4之间的一个整数,表示小脚本的装载状态。这些数及说明如下:
    值 说明 
    1或2 未定义 
    3 小脚本文本已经装载,但是小脚本的HTML页面上控件尚不能起作用 
    4 小脚本装载完毕在一般情况下 
    在readyState属性置为4之前,不要企图访问小脚本的功能。可以使用一个处理程序(handler)通告查看onreadystatechange事件的办法来检查这个属性的值。
URL程序
    规定DHTML小脚本 .htm文件的“统一资源定位程序”(URL),并显示在小脚本容器对象中。
适用于
    Scriptlet Container对象
语法
    ScriptContainer.url = URLString
说明
    在本地也可以在Web服务器上规定任何 .htm文件的URL。这个属性只能在设计期间设置。
重点:
    如果想把小脚本加到一个Web页面上,不要把这个属性设置成当前页面的URL。这样做导致页面的重复调用,从而使得浏览器功能停止。
    如果在拥有一个Web描述体(例如Microsoft Internet Explorer)的宿主应用程序中使用DHTML小脚本,可以规定绝对路径(例如http://myserver/start.htm)或者规定不包含协议、域名路径的相对路径(例如page2.htm)。如果规定一个相对URL,这个路径就是相对于小脚本出现的页面的。
    如果规定的URL是无效的,便显示出错信息,但是小脚本容器对象依然空着。

posted on 2005-04-15 21:42  birdshome  阅读(...)  评论(...编辑  收藏

导航