UiaChangeInfo-Struktur (uiautomationcore.h)

  • Artikel

Enthält Daten zu einer Benutzeroberflächenautomatisierung Änderung, die aufgetreten ist.

Syntax

struct UiaChangeInfo {
  int     uiaId;
  VARIANT payload;
  VARIANT extraInfo;
};

Member

uiaId

Gibt den Typ der Änderungsinformationen an. Mögliche Werte sind alle Werte von Änderungsbezeichnern, Eigenschaftsbezeichnern, Textattributbezeichnern, Anmerkungstypbezeichnern und Stilbezeichnern.

payload

Informationen zum Typ der aufgetretenen Änderung.

extraInfo

Ausführliche Informationen zu der aufgetretenen Änderung.

Hinweise

Der Anbieter kann UiaRaiseChangesEvent aufrufen und ein Array von UiaChangeInfo-Strukturen übergeben, um Clients über eine zugehörige Gruppe von Änderungen zu benachrichtigen. Die Nutzlast und extraInfo variieren je nach der uiaId , die in der UiaChangeInfo-Struktur aufgefüllt wird.

Wenn mehrere dieser Ereignistypen vorhanden sind, werden mehrere UiaChangeInfo-Strukturen erstellt. Nachfolgend finden Sie eine Beschreibung der Werte für jedes Wertepaar.

UiaId payload extraInfo
UIA_SummaryChangeId VT_BSTR

Eine Zeichenfolge, die die Bedeutung der Änderung aus Anwendungssicht beschreibt.

 Ein konstanter ID-Wert vom Anbieter, der die Bedeutung dieses Ereignisses angibt.
Für UIA-Eigenschaftenänderungen, die im Abschnitt Eigenschaftenbezeichner angegeben sind. Type ist der Typ der Eigenschaft, und der Wert ist der neue Wert der Eigenschaft.  
Für Änderungen an Textattributen, die im Abschnitt Textattributebezeichner identifiziert werden, wird extraInfo nicht verwendet. Type ist der Typ des Attributs, und der Wert ist der neue Wert des Attributs.  
Für Anmerkungsänderungen, die im Abschnitt Anmerkungstypbezeichner identifiziert werden, wird extraInfo nicht verwendet. VT_BSTR

Bei Text die Zeichen aus dem Bereich, auf den die Anmerkung angewendet wird.

  
Für Stiländerungen, die im Abschnitt Formatbezeichner angegeben sind, wird extraInfo nicht verwendet. VT_BSTR

Bei Text die Zeichen aus dem Bereich, auf den die Formatvorlage angewendet wird.

  

Anforderungen

Anforderung Wert
Header uiautomationcore.h