Método IAccessibleWindowlessSite::AcquireObjectIdRange (oleacc.h)
Adquire um intervalo de IDs de objeto do host de controle e as marca como reservadas por um controle específico sem janelas.
Sintaxe
HRESULT AcquireObjectIdRange(
[in] long rangeSize,
[in, optional] IAccessibleHandler *pRangeOwner,
[out] long *pRangeBase
);
Parâmetros
[in] rangeSize
O tamanho do intervalo de ID do objeto que está sendo solicitado.
[in, optional] pRangeOwner
O controle sem janelas que está solicitando o intervalo.
[out] pRangeBase
A primeira ID de objeto no intervalo adquirido.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Para evitar o uso de uma ID de objeto que pertença a outro controle sem janelas, um controle deve adquirir um intervalo de ID de objeto antes de chamar a função NotifyWinEvent . Um controle deve adquirir IDs de objeto suficientes para todos os objetos acessíveis contidos. Por exemplo, um controle de árvore com 100 filhos reservaria pelo menos 101 IDs de objeto, uma para a raiz e outra para cada filho. Um controle de árvore que deve crescer reservaria quantas IDs de objeto forem esperadas. Se espera-se que o controle de árvore cresça em várias centenas de crianças, reservaria um intervalo de 1000 IDs apenas para estar seguro.
Quando a janela que contém o controle Microsoft ActiveX recebe uma mensagem WM_GETOBJECT com um valor LPARAM (ID de objeto) que está em um intervalo reservado, ela deve chamar o método IAccessibleHandler::AccessibleObjectFromID para obter um objeto IAccessible para essa ID de objeto.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2012 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | oleacc.h |
| Biblioteca | Oleacc.lib |
| DLL | Oleacc.dll |