StructureChangeType-Enumeration (uiautomationcore.h)

  • Artikel

Enthält Werte, die den Typ der Änderung in der Struktur der Microsoft-Benutzeroberflächenautomatisierung angeben.

Syntax

typedef enum StructureChangeType {
  StructureChangeType_ChildAdded = 0,
  StructureChangeType_ChildRemoved,
  StructureChangeType_ChildrenInvalidated,
  StructureChangeType_ChildrenBulkAdded,
  StructureChangeType_ChildrenBulkRemoved,
  StructureChangeType_ChildrenReordered
} ;

Konstanten

 
StructureChangeType_ChildAdded
Wert: 0
Der Ui Automation-Elementstruktur wurde ein untergeordnetes Element hinzugefügt.
StructureChangeType_ChildRemoved
Ein untergeordnetes Element wurde aus der Ui Automation-Elementstruktur entfernt.
StructureChangeType_ChildrenInvalidated
Untergeordnete Elemente wurden in der Ui Automation-Elementstruktur ungültig gemacht. Dies kann bedeuten, dass ein oder mehrere untergeordnete Elemente hinzugefügt oder entfernt wurden, oder eine Kombination aus beidem. Dieser Wert kann auch angeben, dass eine Unterstruktur in der Benutzeroberfläche durch eine andere ersetzt wurde. Beispielsweise hat sich der gesamte Inhalt eines Dialogfelds auf einmal geändert, oder die Ansicht einer Liste wurde geändert, weil eine anwendung vom Typ Explorer zu einem anderen Speicherort navigiert hat. Die genaue Bedeutung hängt von der Implementierung des Benutzeroberflächenautomatisierungsanbieters ab.
StructureChangeType_ChildrenBulkAdded
Untergeordnete Elemente wurden der Benutzeroberflächenautomatisierungselementstruktur in einem Massenvorgang hinzugefügt.
StructureChangeType_ChildrenBulkRemoved
Untergeordnete Elemente wurden massenhaft aus der Benutzeroberflächenautomatisierungs-Elementstruktur entfernt.
StructureChangeType_ChildrenReordered
Die Reihenfolge der untergeordneten Elemente wurde in der Ui Automation-Elementstruktur geändert. Untergeordnete Elemente wurden möglicherweise hinzugefügt oder entfernt.

Hinweise

Da die Implementierung von Strukturänderungsereignissen vom zugrunde liegenden Benutzeroberflächenframework abhängt, definiert die Benutzeroberflächenautomatisierung keine strenge Regel, die festlegt, wann ein Anbieter vom Senden einzelner ChildAdded- oder ChildRemoved-Ereignisse an das Massenäquivalent wechseln muss. Der Wechsel tritt jedoch in der Regel auf, wenn zwei bis fünf untergeordnete Elemente gleichzeitig hinzugefügt oder entfernt werden. Die Massenereignisse tragen dazu bei, zu verhindern, dass Clients von einzelnen ChildAdded- und ChildRemoved-Ereignissen überflutet werden.

Mit Ausnahme von ChildAdded sind Strukturänderungsereignisse immer dem Containerelement zugeordnet, das die untergeordneten Elemente enthält. Das ChildAdded-Ereignis ist dem Element zugeordnet, das gerade hinzugefügt wurde.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Kopfzeile uiautomationcore.h (uiAutomation.h einschließen)