Compartilhar via


Função CreateStdAccessibleObject (oleacc.h)

Cria um objeto acessível com os métodos e as propriedades do tipo especificado de elemento de interface do usuário fornecido pelo sistema.

Sintaxe

HRESULT CreateStdAccessibleObject(
  [in]  HWND   hwnd,
  [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] idObject

Tipo: LONG

ID do objeto. Esse valor geralmente é OBJID_CLIENT, 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 retornado

Tipo: STDAPI

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um código de erro COM padrão.

Comentários

Os aplicativos de servidor chamam essa função quando contêm um objeto de interface do usuário personalizado semelhante a um objeto fornecido pelo sistema. Os desenvolvedores de servidores podem chamar CreateStdAccessibleObject para substituir os métodos e propriedades IAccessible conforme necessário para corresponder aos objetos 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 para CreateStdAccessibleObject . Os desenvolvedores de servidor ainda devem usar CreateStdAccessibleObject 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 IAccessible .

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

Requisitos

   
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

Createstdaccessibleproxy

IDispatch

Atalhos para expor elementos personalizados da interface do usuário