Função AccessibleObjectFromWindow (oleacc.h)
Recupera o endereço da interface especificada para o objeto associado à janela especificada.
Sintaxe
HRESULT AccessibleObjectFromWindow(
[in] HWND hwnd,
[in] DWORD dwId,
[in] REFIID riid,
[out] void **ppvObject
);
Parâmetros
[in] hwnd
Tipo: HWND
Especifica o identificador de uma janela para a qual um objeto deve ser recuperado. Para recuperar um ponteiro de interface para o cursor ou objeto caret, especifique NULL e use a ID de objeto apropriada em dwObjectID.
[in] dwId
Tipo: DWORD
Especifica a ID do objeto. Esse valor é uma das constantes de identificador de objeto padrão ou uma ID de objeto personalizada, como OBJID_NATIVEOM, que é a ID do objeto para o modelo de objeto nativo do Office. Para obter mais informações sobre OBJID_NATIVEOM, consulte a seção Comentários neste tópico.
[in] riid
Tipo: REFIID
Especifica o identificador de referência da interface solicitada. Esse valor é IID_IAccessible ou IID_IDispatch, mas também pode ser IID_IUnknown ou o IID de qualquer interface com suporte do objeto.
[out] ppvObject
Tipo: void**
Endereço de uma variável de ponteiro que recebe o endereço da interface especificada.
Retornar valor
Tipo: STDAPI
Se for bem-sucedido, retornará S_OK.
Se não for bem-sucedido, retornará um dos seguintes ou outro código de erro COM padrão.
| Código de retorno | Descrição |
|---|---|
|
Um argumento não é válido. |
|
Não há suporte para a interface solicitada. |
Comentários
Os clientes chamam essa função para recuperar o endereço do IAccessible, IDispatch, IEnumVARIANT, IUnknown ou outro ponteiro de interface com suporte.
Assim como acontece com outros métodos e funções IAccessible , os clientes podem receber erros para ponteiros de interface IAccessible devido a uma ação do usuário. Para obter mais informações, consulte Recebendo erros para ponteiros de interface IAccessible.
Os clientes usam essa função para obter acesso ao modelo de objeto nativo do Microsoft Office 2000. O modelo de objeto nativo fornece aos clientes informações de acessibilidade sobre o documento ou a área do cliente de um aplicativo do Office que não é exposto pela Acessibilidade Ativa da Microsoft.
Para obter um ponteiro de interface IDispatch para uma classe compatível com o modelo de objeto nativo, especifique OBJID_NATIVEOM em dwObjectID. Ao usar esse identificador de objeto, o parâmetro hwnd deve corresponder aos seguintes tipos de classe de janela.
| Aplicativo do Office | Classe Window | Ponteiro IDispatch para |
|---|---|---|
| Word | _WwG | Janela |
| Excel | EXCEL7 | Janela |
| PowerPoint | paneClassDC | DocumentWindow |
| Barras de Comandos | MsoCommandBar | CommandBar |
Observe que as classes de janela acima correspondem à janela de documento ou janela do painel mais interna. Para obter mais informações sobre o modelo de objeto do Office, consulte o Guia do Programador do Microsoft Office 2000/Visual Basic.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | oleacc.h |
| Biblioteca | Oleacc.lib |
| DLL | Oleacc.dll |
| Redistribuível | Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95 |