DHTML Scriptlets 容器對(duì)象參考手冊(cè)

DHTML小腳本容器對(duì)象參考手冊(cè),包含DHTML小腳本(Scriptlet)基準(zhǔn)文檔。在這里可以了解如下內(nèi)容:1、窗口對(duì)象擴(kuò)展:這些擴(kuò)展內(nèi)容是在編寫小腳本時(shí)可以使用的屬性與方法。 2、在小腳本容器對(duì)象中可用的屬性與事件:在運(yùn)行期間可以把它們與小腳本實(shí)例一起使用。
DHTML DHTML小腳本窗口對(duì)象擴(kuò)展參考
說明
在以一種DHTML小腳本創(chuàng)建腳本時(shí),可以使用動(dòng)態(tài)HTML(DHTML)對(duì)象模型的下述專門擴(kuò)展內(nèi)容。所有擴(kuò)展可在DHTML window.external對(duì)象中找到。
屬性
frozen , scrollbar, selectableContent, version
方法
bubbleEvent , raiseEvent, setContextMenu
bubbleEvent方法
按照標(biāo)準(zhǔn)事件,從一個(gè)DHTML小腳本向宿主應(yīng)用程序發(fā)送事件通知。
適用于
DHTML window.external對(duì)象
語法
window.external.bubbleEvent ()
說明
使用這種方法把一個(gè)標(biāo)準(zhǔn)DHTML事件(例如onbuttonclick、onmousemove、onkeypress)從一個(gè)DHTML小腳本傳遞到宿主應(yīng)用程序。
frozen屬性
表示小腳本容器對(duì)象是否準(zhǔn)備好處理來自DHTML小腳本的事件。
適用于
DHTML window.external對(duì)象
語法
boolean = window.external.frozen
說明
這個(gè)屬性是只讀型的。當(dāng)其為真時(shí),事件不能被小腳本容器對(duì)象所接受,原因是這個(gè)容器尚未準(zhǔn)備好。當(dāng)其為假時(shí),容器將接受事件通知。
raiseEvent方法
把一個(gè)定制事件通知從一個(gè)DHTML小腳本傳遞給宿主應(yīng)用程序。
適用于
DHTML window.external對(duì)象
語法
window.external.raiseEvent (eventName, eventObject)
參量
eventName
一個(gè)串,作為典型標(biāo)識(shí)要傳遞的事件
eventObject
一種變式類型,典型情況包含一個(gè)引用,這個(gè)引用指向DHTML小腳本上觸發(fā)事件的對(duì)象。
說明
這個(gè)方法是小腳本容器對(duì)象的onscriptletevent事件的補(bǔ)充。使用這種方法把有關(guān)非標(biāo)準(zhǔn)事件的情況通知給宿主應(yīng)用程序。
scrollbar屬性
規(guī)定小腳本容器對(duì)象是否讓DHTML小腳本顯示滾動(dòng)條。
適用于
DHTML Window.external對(duì)象
語法
window.external.scrollbar = boolean
-或者-
ScriptContainer.scrollbar = boolean
說明
這個(gè)屬性可以在設(shè)計(jì)期間和在運(yùn)行期間設(shè)置。作為默認(rèn),這個(gè)屬性的值是假。如果把這個(gè)屬性設(shè)置為真,則:
縱向滾動(dòng)條總出現(xiàn)在該小腳本容器對(duì)象中。如果DHTML小腳本的高度小于小腳本容器對(duì)象的窗口高度,則縱向滾動(dòng)條關(guān)閉。
如果這個(gè)小腳本的寬度大于小腳本容器對(duì)象的窗口寬度出現(xiàn)橫向滾動(dòng)條。
selectableContent屬性
規(guī)定用戶是否可以選擇DHTML小腳本的內(nèi)容。
適用于
DHTML Window.external對(duì)象
語法
window.external.selectableContent = boolean
說明
按照默認(rèn),這個(gè)屬性的值是假。如果這個(gè)屬性是真,用戶可以在DHTML小腳本中選擇文本或?qū)ο螅⑶以谛∧_本容器對(duì)象中顯示出來,然后復(fù)制或拖動(dòng)它們。如果這個(gè)屬性是假,用戶可以點(diǎn)擊小腳本中的事件,但是可以不選擇它們。
setContextMenu方法
構(gòu)造一個(gè)描述體菜單,并在用戶右擊小腳本容器對(duì)象中的DHTML小腳本時(shí)顯示出來。
適用于
DHTML window.external對(duì)象
語法
window.external.setContextMenu(menuDefinition)
參量
menuDefinition
定義包含在描述體菜單中的命令文本和命令。一個(gè)一維陣列,在這個(gè)陣列中使用兩個(gè)元素陣列,n和n + 1,定義菜單項(xiàng):
Element命令文本??旖萱I定義為開始用“&”字符
Element n + 1 在命令被選中時(shí)調(diào)用的方法。不能把參量傳遞給該方法。
注意:
描述體菜單只能在由VBScript或JavaScript編寫的腳本中定義,因?yàn)檫@兩種語言建立的陣列可被setContextMenu方法訪問。
舉例
下邊的腳本定義一個(gè)描述體菜單,帶有三個(gè)命令:

















version屬性
返回版本和用于DHTML小腳本的小腳本容器對(duì)象平臺(tái)。
適用于
DHTML Window.external對(duì)象
語法
version = window.external.version
說明
這個(gè)屬性是只讀型的。版本返回到格式N.nnnn platform中。其中N是表示主版本號(hào)的整數(shù);nnnn是任意個(gè)字符(空格除外),表示次版本號(hào);platform是平臺(tái)(win32、mac和alpha等)。下邊是版本號(hào)的一個(gè)例子:
1.0a win32
可以使用version屬性確定頁面是作為一個(gè)DHTML小腳本來使用還是作為一個(gè)單獨(dú)Web頁面來使用。使用下邊這樣一個(gè)語句:
contro1Mode = (typeof(window.external.version) == "string"
如果在這個(gè)語句執(zhí)行之后,contro1Mode的值是真,這個(gè)頁面就作為一個(gè)DHTML小腳本來使用。否則,這個(gè)頁面就作為一個(gè)獨(dú)立頁面來使用。
DHTML參考
說明
小腳本容器對(duì)象用作一個(gè)應(yīng)用程序中的宿主DHTML小腳本。它所提供的屬性和事件都作為所有DHTML小腳本的標(biāo)準(zhǔn)擴(kuò)展內(nèi)容而隨時(shí)可用。當(dāng)人們?cè)趹?yīng)用程序中用DHTML小腳本進(jìn)行工作時(shí),可以使用下述小腳本容器對(duì)象中的屬性與事件。
屬性
scrollbar、event、readyState和url
事件
onclick事件, ondblclick事件, onkeydown事件, onkeypress事件, onkeyup事件, onmousedown, onmousedown事件, onmousemove事件, onreadystatechange事件, onscriptletevent事件
EVENT屬性
提供從一個(gè)DHTML小腳本傳遞出來的有關(guān)標(biāo)準(zhǔn)DHTML事件的狀態(tài)信息。
適用于
Scriptlet Container對(duì)象
語法
value = ScriptContainer.event.member
說明
這個(gè)屬性是只讀型的。該event屬性提供一種獲取有關(guān)標(biāo)準(zhǔn)事件狀態(tài)信息的方式。這些來自小腳本的標(biāo)準(zhǔn)事件是:onclick、ondblclick、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove和onmouseup。這個(gè)屬性負(fù)責(zé)對(duì)DHTML event對(duì)象作出響應(yīng)。
要想獲取狀態(tài)信息,可以查詢event屬性成員的值。這些成員包括:altKey、ctrlKey、keyCode、offsetX、offsetY、shiftKey、srcElement和type等。下邊腳本例子說明如何使用event屬性獲取有關(guān)標(biāo)準(zhǔn)事件的更多信息:










關(guān)于event屬性的信息,詳見DHTML文檔中的event對(duì)象。
ONCLICK事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)onclick事件時(shí)發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_onclick()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onclick">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
· DHTML小腳本包含onclick事件的處理程序
· DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONDBLCLICK事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)ondblclick事件的時(shí)候發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_ondblClick()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="ondblClick">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
· DHTML小腳本包含ondblclick事件的處理程序
· DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONKEYDOWN事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)onkeydown事件的時(shí)候發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_onkeydown()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeydown">
說明
如果下述兩個(gè)條件都是真,這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
DHTML小腳本包含onkeydown事件的處理程序
DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONKEYPRESS事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)onkeypress事件的時(shí)候發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_onkeypress()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeypress">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
DHTML小腳本包含onkeypress事件的處理程序
DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONKEYUP事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)onkeyup事件的時(shí)候發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_onkeyup()
JavaScript語法
<SCRIPT LANGUAGE="javaScript" FOR="ScriptContainer" EVENT="onkeyup">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
· DHTML小腳本包含onkeyup事件的處理程序
· DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONMOUSEDOWN, ONMOUSEUP事件
在一個(gè)DHTML小腳本轉(zhuǎn)發(fā)一個(gè)onmousedown 或 onmouseup事件時(shí)發(fā)送。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_ onmousedown()
ScriptContainer_ onmouseup()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmousedown">
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmouseup">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
· DHTML小腳本包含onmousedown 或 onmouseup事件的處理程序
· DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONMOUSEMOVE事件
發(fā)送這個(gè)事件,表示一個(gè)DHTML小腳本是否裝載完畢。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_ onmousemove()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmousemove">
說明
如果下述兩個(gè)條件都是真,則這個(gè)小腳本容器對(duì)象就接受這個(gè)事件:
· DHTML小腳本包含onmousemove事件的處理程序
· DHTML小腳本處理程序調(diào)用bubbleEvent方法,把這個(gè)事件傳遞給宿主應(yīng)用程序。
可以借助于查詢小腳本對(duì)象容器事件屬性的辦法獲得有關(guān)這個(gè)事件的狀態(tài)信息。
ONREADYSTATECHANGE事件
發(fā)送這個(gè)事件,表示一個(gè)DHTML小腳本是否裝載完畢。
適用于
Scriptlet Container對(duì)象
Visual Basic語法
ScriptContainer_ onreadystatechange()
JavaScript語法
<SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onreadystatechange">
說明
在一個(gè)DHTML小腳本裝載過程中,這個(gè)事件激發(fā)多次。最后一次激發(fā)表示小腳本的HTML頁面已經(jīng)完全裝載,因而它的腳本可以調(diào)用。為測試當(dāng)前狀態(tài),要獲取小腳本容器對(duì)象的readystate(就緒狀態(tài))屬性的值。
ONSCRIPTLETEVENT事件
通知小腳本容器對(duì)象:在一個(gè)DHTML小腳本中已經(jīng)出現(xiàn)了一個(gè)客戶事件。
適用于
Scriptlet Container對(duì)象
語法
ScriptContainer_ onscriptletevent(eventName, eventObject)
參量
eventName
一個(gè)串,典型情況是表示正在傳遞的事件
eventObject
一種變式類型,典型情況是到小腳本上一個(gè)對(duì)象的引用子。
注意:
這兩種參量的確切內(nèi)容取決在小腳本對(duì)應(yīng)的raiseEvent方法中傳遞的信息是什么。
說明
這個(gè)事件是小腳本raiseEvent方法的一種補(bǔ)充。
READYSTATE屬性
返回寄宿在容器對(duì)象中一個(gè)DHTML小腳本裝載狀態(tài)的有關(guān)信息。
適用于
Scriptlet Container對(duì)象
語法
ScriptContainer.readyState = integer
說明
這個(gè)屬性是只讀型的。只在運(yùn)行期間使用。
這個(gè)readyState屬性返回1與4之間的一個(gè)整數(shù),表示小腳本的裝載狀態(tài)。這些數(shù)及說明如下:
值 說明
1或2 未定義
3 小腳本文本已經(jīng)裝載,但是小腳本的HTML頁面上控件尚不能起作用
4 小腳本裝載完畢在一般情況下
在readyState屬性置為4之前,不要企圖訪問小腳本的功能。可以使用一個(gè)處理程序(handler)通告查看onreadystatechange事件的辦法來檢查這個(gè)屬性的值。
URL程序
規(guī)定DHTML小腳本 .htm文件的“統(tǒng)一資源定位程序”(URL),并顯示在小腳本容器對(duì)象中。
適用于
Scriptlet Container對(duì)象
語法
ScriptContainer.url = URLString
說明
在本地也可以在Web服務(wù)器上規(guī)定任何 .htm文件的URL。這個(gè)屬性只能在設(shè)計(jì)期間設(shè)置。
重點(diǎn):
如果想把小腳本加到一個(gè)Web頁面上,不要把這個(gè)屬性設(shè)置成當(dāng)前頁面的URL。這樣做導(dǎo)致頁面的重復(fù)調(diào)用,從而使得瀏覽器功能停止。
如果在擁有一個(gè)Web描述體(例如Microsoft Internet Explorer)的宿主應(yīng)用程序中使用DHTML小腳本,可以規(guī)定絕對(duì)路徑(例如http://myserver/start.htm)或者規(guī)定不包含協(xié)議、域名路徑的相對(duì)路徑(例如page2.htm)。如果規(guī)定一個(gè)相對(duì)URL,這個(gè)路徑就是相對(duì)于小腳本出現(xiàn)的頁面的。
如果規(guī)定的URL是無效的,便顯示出錯(cuò)信息,但是小腳本容器對(duì)象依然空著。
posted on 2005-04-15 21:42 birdshome 閱讀(453) 評(píng)論(1) 編輯 收藏 收藏至365Key 所屬分類: JScript&DHTML開發(fā)