本文示範如何在 IE 的 JavaScript 中呼叫自製的 COM 元件,涵蓋無參數、輸入參數、輸出參數三種方法,以及屬性的讀寫。
首先建立一個 COM 元件,加入雙介面 Itest,並實作三個方法:
// 無輸入輸出參數
STDMETHODIMP Ctest::test(void)
{
MessageBox(NULL, L"test", L"test", MB_OK);
return S_OK;
}
// 一個 BSTR 輸入參數
STDMETHODIMP Ctest::test1(BSTR a1)
{
MessageBox(NULL, a1, L"test", MB_OK);
return S_OK;
}
// 一個 BSTR* 輸出參數
STDMETHODIMP Ctest::test3(BSTR* a1)
{
MessageBox(NULL, L"test3", L"test", MB_OK);
*a1 = ::SysAllocString(L"烽火連三月家書抵萬金");
return S_OK;
}
這三個方法分別對應無參數、有輸入參數、有輸出參數的情況。編譯完成後用 regsvr32 註冊元件,就能在 IE 中以 JavaScript 呼叫。
1、直接呼叫 COM 方法
<html>
<head>
<title>呼叫 com 元件的方法示例</title>
<script language="javascript">
document.write("<hr>")
var xml = new ActiveXObject("atldll.test.1")
xml.test()
xml.test1("向 com 方法中傳遞參數並呼叫 com 方法")
var str = xml.test3() // 從 com 方法回傳參數
document.write("str" + str)
document.write("<hr>")
</script>
</head>
<body>
演示 IE 腳本程式中呼叫 com 元件的方法
</body>
</html>
2、在 JavaScript 函式中呼叫
<html>
<head>
<title>donghailin active object</title>
<script type="text/javascript">
function displaymessage() {
document.write("<hr>")
var xml = new ActiveXObject("atldll.test.1")
xml.test()
xml.test1("向 com 元件傳遞字串")
var str = xml.test3()
document.write("str" + str)
document.write("<hr>")
}
</script>
</head>
<body>
<form>
<input type="button" value="Click me!" onclick="displaymessage()">
</form>
</body>
</html>
注意:由於元件要供其他系統呼叫,輸入輸出的字串參數應使用 BSTR 型別。
3、設定與取得 COM 元件屬性
先在元件中宣告屬性變數:
BSTR m_bstr;
右鍵點擊介面選擇「新增」→「新增屬性」,屬性型別填 BSTR,屬性名填 bstr,精靈會自動產生 put_bstr 與 get_bstr:
STDMETHODIMP Ctest::get_bstr(BSTR* pVal)
{
*pVal = m_bstr;
return S_OK;
}
STDMETHODIMP Ctest::put_bstr(BSTR newVal)
{
m_bstr = newVal;
MessageBox(NULL, m_bstr, L"屬性測試", MB_OK);
return S_OK;
}
以下示範在 JavaScript 中讀寫該屬性:
<html>
<head>
<title>donghailin active object</title>
<script type="text/javascript">
function displaymessage() {
document.write("<hr>")
var xml = new ActiveXObject("atldll.test.1")
xml.bstr = "滿園春色鎖不住一枝紅杏出牆來" // 設定屬性,對應 C++ 的 put_bstr
document.write("屬性回傳值是:" + xml.bstr) // 取得屬性,對應 get_bstr
document.write("<hr>")
}
</script>
</head>
<body>
<table align="center" width="50">
<form>
<input type="button" value="Click me!" onclick="displaymessage()">
</form>
</table>
</body>
</html>
實務上要特別注意:ActiveXObject 只有在 IE 且安全性設定允許的情況下才能建立,其他瀏覽器完全無法使用;同時 SysAllocString 配置的記憶體需由呼叫端以 SysFreeString 釋放,否則會造成洩漏。這套技術已屬於歷史產物,新專案請改用本機服務搭配 WebSocket 或改用瀏覽器擴充功能來達成同樣目的。