Compartilhar via


Função UiaProviderFromIAccessible (uiautomationcoreapi.h)

Cria um provedor de Automação da Interface do Usuário da Microsoft com base no objeto Microsoft Active Accessibility especificado.

Sintaxe

HRESULT UiaProviderFromIAccessible(
  [in]  IAccessible               *pAccessible,
  [in]  long                      idChild,
  [in]  DWORD                     dwFlags,
  [out] IRawElementProviderSimple **ppProvider
);

Parâmetros

[in] pAccessible

Tipo: IAccessible*

Um ponteiro para o objeto Microsoft Active Accessibility.

[in] idChild

Tipo: long

A ID filho do objeto Microsoft Active Accessibility.

[in] dwFlags

Tipo: DWORD

Um dos seguintes valores:

UIA_PFIA_DEFAULT

UIA_PFIA_UNWRAP_BRIDGE

[out] ppProvider

Tipo: IRawElementProviderSimple**

O novo provedor de Automação da Interface do Usuário.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A Automação da Interface do Usuário fornece compatibilidade com versões anteriores para provedores de Acessibilidade Ativa da Microsoft fornecendo um proxy para eles, chamado de proxy de Automação de Interface do Usuário da Microsoft Active Accessibility. Esse proxy é criado automaticamente quando uma janela responde a uma mensagem de WM_GETOBJECT retornando um provedor de Acessibilidade Ativa da Microsoft. Use UiaProviderFromIAccessible quando precisar criar manualmente um proxy de Automação da Interface do Usuário para a Acessibilidade Ativa da Microsoft; por exemplo, ao implementar a interface IAccessibleEx .

Algumas propriedades, como LabeledBy, devem ser expressas como um provedor de Automação da Interface do Usuário. Um provedor IAccessibleEx pode usar UiaProviderFromIAccessible para encapsular um objeto IAccessible para retorná-lo como o valor da propriedade LabeledBy.

Requisitos

   
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho uiautomationcoreapi.h
Biblioteca Uiautomationcore.lib
DLL Uiautomationcore.dll

Confira também

Funções para provedores

UiaIAccessibleFromProvider