Énumération StructureChangeType (uiautomationcore.h)

  • Article

Contient des valeurs qui spécifient le type de modification dans l’arborescence Microsoft UI Automation.

Syntax

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

Constantes

 
StructureChangeType_ChildAdded
Valeur : 0
Un élément enfant a été ajouté à l’arborescence des éléments UI Automation.
StructureChangeType_ChildRemoved
Un élément enfant a été supprimé de l’arborescence des éléments UI Automation.
StructureChangeType_ChildrenInvalidated
Les éléments enfants ont été invalidés dans l’arborescence des éléments UI Automation. Cela peut signifier qu’un ou plusieurs éléments enfants ont été ajoutés ou supprimés, ou une combinaison des deux. Cette valeur peut également indiquer qu’une sous-arborescence de l’interface utilisateur a été remplacée par une autre. Par exemple, l’intégralité du contenu d’une boîte de dialogue a été modifiée en même temps ou l’affichage d’une liste a changé parce qu’une application de type Explorer a accédé à un autre emplacement. La signification exacte dépend de l’implémentation du fournisseur UI Automation.
StructureChangeType_ChildrenBulkAdded
Des éléments enfants ont été ajoutés en bloc à l’arborescence des éléments UI Automation.
StructureChangeType_ChildrenBulkRemoved
Les éléments enfants ont été supprimés en bloc de l’arborescence des éléments UI Automation.
StructureChangeType_ChildrenReordered
L’ordre des éléments enfants a changé dans l’arborescence des éléments UI Automation. Des éléments enfants peuvent avoir été ajoutés ou supprimés.

Remarques

Étant donné que l’implémentation d’événements de changement de structure dépend de l’infrastructure d’interface utilisateur sous-jacente, UI Automation ne définit aucune règle stricte régissant lorsqu’un fournisseur doit passer de l’envoi d’événements ChildAdded ou ChildRemoved individuels à l’équivalent en bloc. Toutefois, le changement se produit généralement lorsque deux à cinq éléments enfants sont ajoutés ou supprimés à la fois. Les événements en bloc permettent d’empêcher les clients d’être inondés par des événements ChildAdded et ChildRemoved individuels.

À l’exception de ChildAdded, les événements de modification de structure sont toujours associés à l’élément conteneur qui contient les enfants. L’événement ChildAdded est associé à l’élément qui vient d’être ajouté.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
En-tête uiautomationcore.h (incluez UIAutomation.h)