Metodo IAccessibleWindowlessSite::AcquireObjectIdRange (oleacc.h)

Acquisisce un intervallo di ID oggetto dall'host del controllo e li contrassegna come riservati da un controllo senza finestra specifico.

Sintassi

HRESULT AcquireObjectIdRange(
  [in]           long               rangeSize,
  [in, optional] IAccessibleHandler *pRangeOwner,
  [out]          long               *pRangeBase
);

Parametri

[in] rangeSize

Dimensione dell'intervallo id oggetto richiesto.

[in, optional] pRangeOwner

Controllo senza finestra che richiede l'intervallo.

[out] pRangeBase

Primo ID oggetto nell'intervallo acquisito.

Valore restituito

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per evitare di usare un ID oggetto appartenente a un altro controllo senza finestra, un controllo deve acquisire un intervallo ID oggetto prima di chiamare la funzione NotifyWinEvent . Un controllo deve acquisire sufficienti ID oggetto per tutti gli oggetti accessibili contenuti. Ad esempio, un controllo albero con 100 figli riserva almeno 101 ID oggetto, uno per la radice e uno per ogni figlio. Un controllo albero che dovrebbe crescere riserva tutti gli ID oggetto previsti. Se il controllo albero dovrebbe crescere di diverse centinaia di bambini, riserva una gamma di 1000 ID solo per essere sicuri.

Quando la finestra contenente il controllo Microsoft ActiveX riceve un messaggio di WM_GETOBJECT con un valore LPARAM (ID oggetto) incluso in un intervallo riservato, deve chiamare il metodo IAccessibleHandler::AccessibleObjectFromID per ottenere un oggetto IAccessible per tale ID oggetto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	oleacc.h
Libreria	Oleacc.lib
DLL	Oleacc.dll

Vedi anche

IAccessibleWindowlessSite

IAccessibleWindowlessSite::ReleaseObjectIdRange