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 |