IAccessibleWindowlessSite::AcquireObjectIdRange 方法 (oleacc.h)
從控件主機取得物件標識符的範圍,並將其標示為由特定無視窗控件保留。
語法
HRESULT AcquireObjectIdRange(
[in] long rangeSize,
[in, optional] IAccessibleHandler *pRangeOwner,
[out] long *pRangeBase
);
參數
[in] rangeSize
要求的物件標識碼範圍大小。
[in, optional] pRangeOwner
要求範圍的無視窗控制件。
[out] pRangeBase
取得範圍中的第一個物件標識碼。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
若要避免使用屬於另一個無視窗控件的物件標識符,控件應該先取得對象標識元範圍,再呼叫 NotifyWinEvent 函式。 控件應該取得足夠的物件識別碼,以供其所有包含的可存取物件使用。 例如,具有100個子系的樹狀結構控件會保留至少101個物件識別碼、一個用於根目錄,一個用於每個子系。 預期成長的樹狀結構控件會保留如預期一樣多的物件標識碼。 如果樹狀結構控件預期會成長數百個子系,它會保留 1000 個標識符的範圍,只是為了安全。
當包含 Microsoft ActiveX 控制件的視窗收到具有 LPARAM 值 ( 物件識別碼的WM_GETOBJECT訊息) 位於保留範圍時,它應該呼叫 IAccessibleHandler::AccessibleObjectFromID 方法,以取得該物件標識符的 IAccessible 物件。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleacc.h |
程式庫 | Oleacc.lib |
Dll | Oleacc.dll |