DIV CSS 佈局教程網

在 JavaScript 中呼叫 COM 元件:方法、參數與屬性的完整實作
編輯:關於JavaScript     

本文示範如何在 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 或改用瀏覽器擴充功能來達成同樣目的。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved