Compartilhar via


Método IAccessible::get_accChildCount (oleacc.h)

O método IAccessible::get_accChildCount recupera o número de filhos que pertencem a esse objeto. Todos os objetos devem dar suporte a essa propriedade.

Sintaxe

HRESULT get_accChildCount(
  [out, retval] long *pcountChildren
);

Parâmetros

[out, retval] pcountChildren

Tipo: long*

Endereço de uma variável que recebe o número de filhos que pertencem a esse objeto. Os filhos são objetos acessíveis ou elementos filho. Se o objeto não tiver filhos, esse valor será zero.

Retornar valor

Tipo: HRESULT

Se for bem-sucedido, retornará S_OK.

Se não for bem-sucedido, retornará um código de erro COM padrão. Os servidores retornam esses valores, mas os clientes devem sempre marcar parâmetros de saída para garantir que eles contenham valores válidos. Para obter mais informações, consulte Verificando valores retornados do IAccessible.

Comentários

O número de filhos em um objeto pode ser alterado. Um aplicativo rastreia as alterações na contagem de filhos observando EVENT_OBJECT_CREATE e EVENT_OBJECT_DESTROY eventos gerados por esse objeto.

Observação para desenvolvedores de servidores: Se o objeto não tiver filhos, retorne S_OK e defina pcountChildren como zero.

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

AccessibleChildren

Iaccessible

IAccessible::get_accChild

IAccessible::get_accParent