在網頁中嵌入 ActiveX 控制項時,若需要傳入初始參數,標準做法是使用 <param> 標籤。以下是一個可以直接運作的最小範例。
<HTML>
<HEAD>
<TITLE>Test ActiveX</TITLE>
</HEAD>
<BODY>
<OBJECT ID="TestCtrl" NAME="TestCtrl"
CODEBASE="calc.CAB#version=1,0,0,1"
CLASSID="clsid:CDF1D789-F8A3-48F2-B0DE-0D72F2D89F76">
<PARAM NAME="downpath" VALUE="123456" />
</OBJECT>
<script language="javascript">
function doTest() {
alert(TestCtrl.downpath);
}
</script>
<input type="button" value="Get value" id="btnOK" onclick="doTest();" />
</BODY>
</HTML>
幾個重點說明:
ID 與 NAME 都設為 TestCtrl,JavaScript 才能透過這個名稱直接存取控制項。CLASSID 是唯一識別該控制項的 GUID,每個控制項都不同。CODEBASE 指定 CAB 封裝檔的位置與版本號,用於自動下載安裝。<PARAM NAME="downpath" VALUE="123456" /> 這行把名為 downpath 的屬性初始值設為 123456。如果你在控制項中建立了一個 BSTR 型別、名稱為 downpath 的屬性,需要在 DoPropExchange 中補上對應的交換程式碼。建立屬性時請選擇 member variable 方式,然後在下列函式中加入 PX_String:
void COCXTestCtrl::DoPropExchange(CPropExchange* pPX)
{
ExchangeVersion(pPX, MAKELONG(_wVerMinor, _wVerMajor));
COleControl::DoPropExchange(pPX);
// TODO: Call PX_ functions for each persistent custom property.
PX_String(pPX, _T("downpath"), m_downpath, _T(""));
}
這行程式的意義是:把 HTML 中 <PARAM> 所指定的值("123456")與控制項的成員變數 m_downpath 做綁定。少了這一步,即使 HTML 端寫了 param,控制項也讀不到值。
ActiveX 僅能在 Internet Explorer 中執行,且需要使用者手動允許,加上安全性上的先天限制,這項技術現今已不建議用於新專案。若只是需要在瀏覽器中執行原生程式碼,可考慮改用 WebAssembly 或本機化的桌面應用方案。