DHTML小腳本容器對象參考手冊，包含DHTML小腳本（Scriptlet）基準文檔。在這里可以了解如下內容：1、窗口對象擴展：這些擴展內容是在編寫小腳本時可以使用的屬性與方法。 2、在小腳本容器對象中可用的屬性與事件：在運行期間可以把它們與小腳本實例一起使用。 

DHTML DHTML小腳本窗口對象擴展參考

說明
    在以一種DHTML小腳本創(chuàng)建腳本時，可以使用動態(tài)HTML（DHTML）對象模型的下述專門擴展內容。所有擴展可在DHTML window.external對象中找到。
屬性
    frozen , scrollbar, selectableContent, version
方法
    bubbleEvent , raiseEvent, setContextMenu

---

bubbleEvent方法
    按照標準事件，從一個DHTML小腳本向宿主應用程序發(fā)送事件通知。
適用于
    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小腳本上觸發(fā)事件的對象。
說明
    這個方法是小腳本容器對象的onscriptletevent事件的補充。使用這種方法把有關非標準事件的情況通知給宿主應用程序。

---

scrollbar屬性
    規(guī)定小腳本容器對象是否讓DHTML小腳本顯示滾動條。
適用于
    DHTML Window.external對象
語法
    window.external.scrollbar = boolean
    －或者－
    ScriptContainer.scrollbar = boolean
說明
    這個屬性可以在設計期間和在運行期間設置。作為默認，這個屬性的值是假。如果把這個屬性設置為真，則：
    縱向滾動條總出現(xiàn)在該小腳本容器對象中。如果DHTML小腳本的高度小于小腳本容器對象的窗口高度，則縱向滾動條關閉。
    如果這個小腳本的寬度大于小腳本容器對象的窗口寬度出現(xiàn)橫向滾動條。

---

selectableContent屬性
    規(guī)定用戶是否可以選擇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方法訪問。
舉例
    下邊的腳本定義一個描述體菜單，帶有三個命令：

 

---

version屬性
    返回版本和用于DHTML小腳本的小腳本容器對象平臺。
適用于
    DHTML Window.external對象
語法
    version = window.external.version
說明
    這個屬性是只讀型的。版本返回到格式N.nnnn platform中。其中N是表示主版本號的整數(shù)；nnnn是任意個字符（空格除外），表示次版本號；platform是平臺（win32、mac和alpha等）。下邊是版本號的一個例子：
    1.0a win32
    可以使用version屬性確定頁面是作為一個DHTML小腳本來使用還是作為一個單獨Web頁面來使用。使用下邊這樣一個語句：
    contro1Mode = (typeof(window.external.version) == "string"
    如果在這個語句執(zhí)行之后，contro1Mode的值是真，這個頁面就作為一個DHTML小腳本來使用。否則，這個頁面就作為一個獨立頁面來使用。

---

DHTML參考
說明
    小腳本容器對象用作一個應用程序中的宿主DHTML小腳本。它所提供的屬性和事件都作為所有DHTML小腳本的標準擴展內容而隨時可用。當人們在應用程序中用DHTML小腳本進行工作時，可以使用下述小腳本容器對象中的屬性與事件。
屬性
    scrollbar、event、readyState和url
事件
    onclick事件, ondblclick事件, onkeydown事件, onkeypress事件, onkeyup事件, onmousedown, onmousedown事件, onmousemove事件, onreadystatechange事件, onscriptletevent事件

---

EVENT屬性
    提供從一個DHTML小腳本傳遞出來的有關標準DHTML事件的狀態(tài)信息。
適用于
    Scriptlet Container對象
語法
    value = ScriptContainer.event.member
說明
    這個屬性是只讀型的。該event屬性提供一種獲取有關標準事件狀態(tài)信息的方式。這些來自小腳本的標準事件是：onclick、ondblclick、onkeydown、onkeypress、onkeyup、onmousedown、onmousemove和onmouseup。這個屬性負責對DHTML event對象作出響應。
    要想獲取狀態(tài)信息，可以查詢event屬性成員的值。這些成員包括：altKey、ctrlKey、keyCode、offsetX、offsetY、shiftKey、srcElement和type等。下邊腳本例子說明如何使用event屬性獲取有關標準事件的更多信息：

    關于event屬性的信息，詳見DHTML文檔中的event對象。

---

ONCLICK事件
    在一個DHTML小腳本轉發(fā)一個onclick事件時發(fā)送。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_onclick()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onclick">
說明
    如果下述兩個條件都是真，則這個小腳本容器對象就接受這個事件：
    · DHTML小腳本包含onclick事件的處理程序
    · DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。
可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONDBLCLICK事件
    在一個DHTML小腳本轉發(fā)一個ondblclick事件的時候發(fā)送。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_ondblClick()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="ondblClick">
說明
    如果下述兩個條件都是真，則這個小腳本容器對象就接受這個事件：
    · DHTML小腳本包含ondblclick事件的處理程序
    · DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONKEYDOWN事件
    在一個DHTML小腳本轉發(fā)一個onkeydown事件的時候發(fā)送。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_onkeydown()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeydown">
說明
    如果下述兩個條件都是真，這個小腳本容器對象就接受這個事件：
    DHTML小腳本包含onkeydown事件的處理程序
    DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONKEYPRESS事件
    在一個DHTML小腳本轉發(fā)一個onkeypress事件的時候發(fā)送。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_onkeypress()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT"="onkeypress">
說明
    如果下述兩個條件都是真，則這個小腳本容器對象就接受這個事件：
    DHTML小腳本包含onkeypress事件的處理程序 
    DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。 
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONKEYUP事件
    在一個DHTML小腳本轉發(fā)一個onkeyup事件的時候發(fā)送。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_onkeyup()
JavaScript語法
    <SCRIPT LANGUAGE="javaScript" FOR="ScriptContainer" EVENT="onkeyup">
說明
    如果下述兩個條件都是真，則這個小腳本容器對象就接受這個事件：
    · DHTML小腳本包含onkeyup事件的處理程序
    · DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONMOUSEDOWN, ONMOUSEUP事件
    在一個DHTML小腳本轉發(fā)一個onmousedown 或 onmouseup事件時發(fā)送。
適用于
    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方法，把這個事件傳遞給宿主應用程序。
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

---

ONMOUSEMOVE事件
    發(fā)送這個事件，表示一個DHTML小腳本是否裝載完畢。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_ onmousemove()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onmousemove">
說明
    如果下述兩個條件都是真，則這個小腳本容器對象就接受這個事件：
    · DHTML小腳本包含onmousemove事件的處理程序
    · DHTML小腳本處理程序調用bubbleEvent方法，把這個事件傳遞給宿主應用程序。
    可以借助于查詢小腳本對象容器事件屬性的辦法獲得有關這個事件的狀態(tài)信息。

 

---

 

ONREADYSTATECHANGE事件
    發(fā)送這個事件，表示一個DHTML小腳本是否裝載完畢。
適用于
    Scriptlet Container對象
Visual Basic語法
    ScriptContainer_ onreadystatechange()
JavaScript語法
    <SCRIPT LANGUAGE="JavaScript" FOR="ScriptContainer" EVENT="onreadystatechange">
說明
    在一個DHTML小腳本裝載過程中，這個事件激發(fā)多次。最后一次激發(fā)表示小腳本的HTML頁面已經完全裝載，因而它的腳本可以調用。為測試當前狀態(tài)，要獲取小腳本容器對象的readystate（就緒狀態(tài)）屬性的值。

---

ONSCRIPTLETEVENT事件
    通知小腳本容器對象：在一個DHTML小腳本中已經出現(xiàn)了一個客戶事件。
適用于
    Scriptlet Container對象
語法
    ScriptContainer_ onscriptletevent(eventName, eventObject)
參量
    eventName
    一個串，典型情況是表示正在傳遞的事件
    eventObject
    一種變式類型，典型情況是到小腳本上一個對象的引用子。
注意：
    這兩種參量的確切內容取決在小腳本對應的raiseEvent方法中傳遞的信息是什么。
說明
    這個事件是小腳本raiseEvent方法的一種補充。

---

READYSTATE屬性
    返回寄宿在容器對象中一個DHTML小腳本裝載狀態(tài)的有關信息。
適用于
    Scriptlet Container對象
語法
    ScriptContainer.readyState = integer
說明
    這個屬性是只讀型的。只在運行期間使用。
    這個readyState屬性返回1與4之間的一個整數(shù)，表示小腳本的裝載狀態(tài)。這些數(shù)及說明如下：
    值 說明 
    1或2 未定義 
    3 小腳本文本已經裝載，但是小腳本的HTML頁面上控件尚不能起作用 
    4 小腳本裝載完畢在一般情況下 
    在readyState屬性置為4之前，不要企圖訪問小腳本的功能。可以使用一個處理程序（handler）通告查看onreadystatechange事件的辦法來檢查這個屬性的值。

---

URL程序
    規(guī)定DHTML小腳本 .htm文件的“統(tǒng)一資源定位程序”（URL），并顯示在小腳本容器對象中。
適用于
    Scriptlet Container對象
語法
    ScriptContainer.url = URLString
說明
    在本地也可以在Web服務器上規(guī)定任何 .htm文件的URL。這個屬性只能在設計期間設置。
重點：
    如果想把小腳本加到一個Web頁面上，不要把這個屬性設置成當前頁面的URL。這樣做導致頁面的重復調用，從而使得瀏覽器功能停止。
    如果在擁有一個Web描述體（例如Microsoft Internet Explorer）的宿主應用程序中使用DHTML小腳本，可以規(guī)定絕對路徑（例如http://myserver/start.htm）或者規(guī)定不包含協(xié)議、域名路徑的相對路徑（例如page2.htm）。如果規(guī)定一個相對URL，這個路徑就是相對于小腳本出現(xiàn)的頁面的。
    如果規(guī)定的URL是無效的，便顯示出錯信息，但是小腳本容器對象依然空著。