Поделиться через


Функция UiaRaiseStructureChangedEvent (uiautomationcoreapi.h)

Вызывается поставщиком для уведомления ядра Microsoft модель автоматизации пользовательского интерфейса о том, что структура дерева изменилась.

Синтаксис

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

Параметры

[in] pProvider

Тип: IRawElementProviderSimple*

Узел поставщика, в котором произошло изменение дерева.

[in] structureChangeType

Тип: StructureChangeType

Тип изменения, которое произошло в дереве.

[in] pRuntimeId

Тип: int*

Идентификаторы среды выполнения для дочерних элементов узла поставщика, где произошло изменение дерева. Этот параметр используется только в том случае, если параметр structureChangeType имеет StructureChangeType_ChildRemoved; значение NULL для всех остальных событий изменения структуры.

Примечание Для Windows 7 массив целых чисел, на которые указывает pRuntimeId , может содержать частичный набор идентификаторов, определяющих только те элементы, на которые влияет изменение структуры.

[in] cRuntimeIdLen

Тип: int

Длина массива целых чисел.

Возвращаемое значение

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Примером изменения древовидной структуры являются дочерние элементы, добавляемые в список или удаляемые из него, а также разворачиваемые или свернутые в представлении в виде дерева.

Требования

Требование Значение
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header uiautomationcoreapi.h
Библиотека Uiautomationcore.lib
DLL Uiautomationcore.dll