Função CreateStdAccessibleProxyA (oleacc.h)

Artigo
11/20/2024

Cria um objeto acessível que tem as propriedades e os métodos da classe especificada do elemento de interface do usuário fornecido pelo sistema.

Sintaxe

HRESULT CreateStdAccessibleProxyA(
  [in]  HWND   hwnd,
  [in]  LPCSTR pClassName,
  [in]  LONG   idObject,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Parâmetros

[in] hwnd

Tipo: HWND

Identificador de janela do elemento de interface do usuário fornecido pelo sistema (um controle) para o qual um objeto acessível é criado.

[in] pClassName

Tipo: LPCTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo do nome de classe de um elemento de interface do usuário fornecido pelo sistema para o qual um objeto acessível é criado. O nome da classe de janela é um dos controles comuns (definidos em Comctl32.dll), controles predefinidos (definidos em User32.dll) ou elementos de janela.

[in] idObject

Tipo: LONG

ID do objeto. Esse valor geralmente é OBJID_CLIENT, que é uma das constantes do identificador de objeto, mas pode ser outro identificador de objeto.

[in] riid

Tipo: REFIID

Identificador de referência da interface solicitada. Esse valor é um dos seguintes: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT ou IID_IUnknown.

[out] ppvObject

Tipo: void**

Endereço de uma variável de ponteiro que recebe o endereço da interface especificada.

Valor de retorno

Tipo: STDAPI

Se tiver êxito, retornará S_OK.

Se não tiver êxito, retornará um código de erro COM padrão.

Observações

Os aplicativos de servidor chamam essa função quando contêm um controle personalizado semelhante a um controle fornecido pelo sistema. Aplicativos de servidor podem chamar CreateStdAccessibleProxy para substituir os métodos e propriedades do IAccessible , conforme necessário, para corresponder aos controles personalizados. Como alternativa, os desenvolvedores de servidores podem usar a Anotação Dinâmica para substituir propriedades específicas sem precisar usar técnicas de subclasse difíceis necessárias com CreateStdAccessibleProxy. Os desenvolvedores de servidor ainda devem usar CreateStdAccessibleProxy para alterações estruturais, como ocultar um elemento filho ou criar um elemento filho de espaço reservado. Essa abordagem salva os desenvolvedores de servidores do trabalho de implementar totalmente todas as propriedades e métodos do IAccessible .

Essa função é semelhante a CreateStdAccessibleObject, exceto que CreateStdAccessibleObject sempre usa o nome da classe associado ao hwnd enquanto CreateStdAccessibleProxy permite especificar o nome da classe como um parâmetro.

Use CreateStdAccessibleProxy para criar um objeto acessível para um elemento de interface do usuário superclasse. Quando um elemento de interface do usuário é superclasse, um aplicativo cria um controle personalizado com um nome de classe de janela diferente do controle predefinido no qual ele se baseia. Como o nome da classe associado ao parâmetro hwnd é o nome da classe de janela de superclasse, especifique o nome da classe base (o nome da classe do sistema no qual o controle superclasse se baseia) em pszClassName.

Nota

O cabeçalho oleacc.h define CreateStdAccessibleProxy como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	oleacc.h
biblioteca	Oleacc.lib
de DLL	Oleacc.dll
redistribuível	Active Accessibility 1.3 RDK no Windows NT 4.0 com SP6 e posterior e Windows 95

Consulte também

apêndice A: Referência de elementos de interface do usuário com suporte

CreateStdAccessibleObject

de IDispatch

atalhos para expor elementos personalizados da interface do usuário

Compartilhar via