共用方式為


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

另請參閱

IAccessibleWindowlessSite

IAccessibleWindowlessSite::ReleaseObjectIdRange