Função UiaRaiseStructureChangedEvent (uiautomationcoreapi.h)

  • Artigo

Chamado por um provedor para notificar o núcleo do Microsoft Automação da Interface do Usuário que a estrutura da árvore foi alterada.

Sintaxe

HRESULT UiaRaiseStructureChangedEvent(
  [in] IRawElementProviderSimple *pProvider,
  [in] StructureChangeType       structureChangeType,
  [in] int                       *pRuntimeId,
  [in] int                       cRuntimeIdLen
);

Parâmetros

[in] pProvider

Tipo: IRawElementProviderSimple*

O nó do provedor em que ocorreu a alteração da árvore.

[in] structureChangeType

Tipo: StructureChangeType

O tipo de alteração que ocorreu na árvore.

[in] pRuntimeId

Tipo: int*

As IDs de runtime para os elementos filho do nó do provedor em que ocorreu a alteração da árvore. Esse parâmetro é usado somente quando structureChangeType é StructureChangeType_ChildRemoved; é NULL para todos os outros eventos de alteração de estrutura.

Nota Para o Windows 7, a matriz de inteiros apontada por pRuntimeId pode conter um conjunto parcial de IDs que identificam apenas os elementos afetados pela alteração da estrutura.

[in] cRuntimeIdLen

Tipo: int

Comprimento da matriz de inteiros.

Retornar valor

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

Um exemplo de uma alteração na estrutura de árvore são elementos filho sendo adicionados ou removidos de uma caixa de listagem ou sendo expandidos ou recolhidos em um modo de exibição de árvore.

Requisitos

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