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
E_INVALIDARG	Um argumento não é válido.
E_NOINTERFACE	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

Confira também

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

IDispatch