Compartilhar via

Função UiaProviderForNonClient (uiautomationcoreapi.h)

  • Artigo

Obtém o provedor para toda a área não cliente de uma janela ou para um controle na área não cliente de uma janela.

Sintaxe

HRESULT UiaProviderForNonClient(
  [in]  HWND                      hwnd,
  [in]  long                      idObject,
  [in]  long                      idChild,
  [out] IRawElementProviderSimple **ppProvider
);

Parâmetros

[in] hwnd

Tipo: HWND

A janela que possui a área não cliente ou o controle não cliente.

[in] idObject

Tipo: long

O identificador de objeto do controle não cliente ou OBJID_WINDOW para toda a área não cliente. Para obter uma lista de valores possíveis, consulte Identificadores de objeto.

[in] idChild

Tipo: long

O identificador filho do controle não cliente.

[out] ppProvider

Tipo: IRawElementProviderSimple**

Recebe o provedor para a área não cliente ou controle não cliente.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro caso contrário.

Comentários

Essa função retorna o provedor padrão do Microsoft Automação da Interface do Usuário para a área não cliente de uma janela. Automação da Interface do Usuário dá suporte à área não cliente sem nenhuma ajuda explícita da janela. Você pode substituir e personalizar o suporte usando a interface IRawElementProviderSimple recuperada por essa função.

Essa função é particularmente útil quando você a usa com o sinalizador ProviderOptions_RefuseNonClientSupport, que desabilita o provedor padrão Automação da Interface do Usuário para a área não cliente para que a janela possa fornecer seu próprio provedor.

As IDs de objeto com suporte para controles na área não cliente incluem OBJID_WINDOW, OBJID_VSCROLL, OBJID_HSCROLL, OBJID_TITLEBAR, OBJID_MENU e OBJID_SIZEGRIP. Para OBJID_TITLEBAR, use a ID filho para distinguir entre a barra de título inteira e os botões que ela contém.

Requisitos

Requisito Valor
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