VARIANT 結構
大部分的 Microsoft Active Accessibility 函式和 IAccessible 屬性和方法會採用 VARIANT 結構作為參數。 基本上,VARIANT 結構是裝載許多數據類型之大型聯集的容器。
結構第一個成員中的值,vt,描述哪一個聯集成員有效。 雖然 VARIANT 結構支援許多不同的數據類型,Microsoft Active Accessibility 只使用下列類型。
vt 值 | 對應的值成員名稱 |
---|---|
VT_I4 | lVal |
VT_DISPATCH | pdispVal |
VT_BSTR | bstrVal |
VT_EMPTY | 沒有 |
當您在 VARIANT 結構中收到資訊時,請檢查 vt 成員,以找出哪個成員包含有效的數據。 同樣地,當您使用 VARIANT 結構傳送資訊時,請一律設定 vt,以反映包含資訊的等位成員。
使用 結構之前,請先呼叫 VariantInit 元件物件模型 (COM) 函式來初始化它。 當 結構完成時,請在包含 VARIANT 的記憶體之前清除它,方法是呼叫 VariantClear來釋放它。