IUIAutomation-Schnittstelle (uiautomationclient.h)

Macht Methoden verfügbar, mit denen Microsoft Benutzeroberflächenautomatisierung Clientanwendungen Benutzeroberflächenautomatisierung Elemente ermitteln, darauf zugreifen und filtern können. Benutzeroberflächenautomatisierung macht jedes Element der Benutzeroberflächenautomatisierung als objekt verfügbar, das von der IUIAutomation-Schnittstelle dargestellt wird. Die Member dieser Schnittstelle sind nicht spezifisch für ein bestimmtes Element.

Vererbung

Die IUIAutomation-Schnittstelle erbt von der IUnknown-Schnittstelle . IUIAutomation verfügt auch über folgende Arten von Membern:

Methoden

Die IUIAutomation-Schnittstelle verfügt über diese Methoden.

IUIAutomation::AddAutomationEventHandler Registriert eine Methode, die Microsoft Benutzeroberflächenautomatisierung-Ereignisse verarbeitet. Hinweis Vor der Implementierung eines Ereignishandlers sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.
IUIAutomation::AddFocusChangedEventHandler Registriert eine Methode, die Fokusänderungsereignisse verarbeitet. Hinweis Vor der Implementierung eines Ereignishandlers sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.
IUIAutomation::AddPropertyChangedEventHandler Registriert eine Methode, die und ein Array von Eigenschaftsänderungsereignissen verarbeitet.
IUIAutomation::AddPropertyChangedEventHandlerNativeArray Registriert eine Methode, die ein systemeigenes Array von Ereignissen behandelt, die geänderte Eigenschaften aufweisen.
IUIAutomation::AddStructureChangedEventHandler Registriert eine Methode, die strukturänderungsbedingte Ereignisse verarbeitet. Hinweis Vor der Implementierung eines Ereignishandlers sollten Sie mit den Threadingproblemen vertraut sein, die unter Grundlegendes zu Threadingproblemen beschrieben werden.
IUIAutomation::CheckNotSupported Überprüft einen bereitgestellten VARIANT-Wert, um festzustellen, ob er den Bezeichner Nicht unterstützt enthält.
IUIAutomation::CompareElements Vergleicht zwei Benutzeroberflächenautomatisierung-Elemente, um zu bestimmen, ob sie das gleiche zugrunde liegende UI-Element darstellen.
IUIAutomation::CompareRuntimeIds Vergleicht zwei ganzzahlige Arrays, die Laufzeitbezeichner (IDs) enthalten, um zu bestimmen, ob ihr Inhalt identisch ist und sie zum gleichen UI-Element gehören.
IUIAutomation::CreateAndCondition Erstellt eine Bedingung, die Elemente auswählt, die beiden bedingungen entsprechen.
IUIAutomation::CreateAndConditionFromArray Erstellt eine Bedingung, die Elemente basierend auf mehreren Bedingungen auswählt, die alle true sein müssen.
IUIAutomation::CreateAndConditionFromNativeArray Erstellt eine Bedingung, die Elemente aus einem nativen Array basierend auf mehreren Bedingungen auswählt, die alle wahr sein müssen.
IUIAutomation::CreateCacheRequest Erstellt eine Cacheanforderung.
IUIAutomation::CreateFalseCondition Erstellt eine Bedingung, die immer false ist.
IUIAutomation::CreateNotCondition Erstellt eine Bedingung, die die negative einer angegebenen Bedingung ist.
IUIAutomation::CreateOrCondition Erstellt eine Kombination aus zwei Bedingungen, bei denen eine Übereinstimmung vorhanden ist, wenn eine der Bedingungen erfüllt ist.
IUIAutomation::CreateOrConditionFromArray Erstellt eine Kombination aus zwei oder mehr Bedingungen, bei denen eine Übereinstimmung vorhanden ist, wenn eine der Bedingungen erfüllt ist.
IUIAutomation::CreateOrConditionFromNativeArray Erstellt eine Kombination aus zwei oder mehr Bedingungen, bei denen eine Übereinstimmung vorhanden ist, wenn eine der Bedingungen erfüllt ist.
IUIAutomation::CreatePropertyCondition Erstellt eine Bedingung, die Elemente auswählt, die über eine -Eigenschaft mit dem angegebenen Wert verfügen.
IUIAutomation::CreatePropertyConditionEx Erstellt eine Bedingung, die Elemente mit einer Eigenschaft mit dem angegebenen Wert unter Verwendung optionaler Flags auswählt.
IUIAutomation::CreateProxyFactoryEntry Erstellt eine neue instance eines Proxyfactoryobjekts.
IUIAutomation::CreateTreeWalker Ruft ein Tree Walker-Objekt ab, das zum Durchlaufen der Microsoft Benutzeroberflächenautomatisierung-Struktur verwendet werden kann.
IUIAutomation::CreateTrueCondition Ruft eine vordefinierte Bedingung ab, die alle Elemente auswählt.
IUIAutomation::ElementFromHandle Ruft ein Benutzeroberflächenautomatisierung-Element für das angegebene Fenster ab.
IUIAutomation::ElementFromHandleBuildCache Ruft ein Benutzeroberflächenautomatisierung-Element für das angegebene Fenster ab, ruft die angeforderten Eigenschaften und Steuerelementmuster vorab ab und speichert die vorab abgerufenen Elemente im Cache.
IUIAutomation::ElementFromIAccessible Ruft ein Benutzeroberflächenautomatisierung-Element für das angegebene barrierefreie Objekt von einem Microsoft Active Accessibility-Server ab.
IUIAutomation::ElementFromIAccessibleBuildCache Ruft ein Benutzeroberflächenautomatisierung-Element für das angegebene barrierefreie Objekt von einem Microsoft Active Accessibility-Server ab, ruft die angeforderten Eigenschaften und Steuerelementmuster vorab ab und speichert die vorab abgerufenen Elemente im Cache.
IUIAutomation::ElementFromPoint Ruft das Benutzeroberflächenautomatisierung-Element am angegebenen Punkt auf dem Desktop ab.
IUIAutomation::ElementFromPointBuildCache Ruft das Benutzeroberflächenautomatisierung-Element am angegebenen Punkt auf dem Desktop ab, ruft die angeforderten Eigenschaften und Steuerelementmuster vorab ein und speichert die vorab abgerufenen Elemente im Cache.
IUIAutomation::get_ContentViewCondition Ruft eine vordefinierte IUIAutomationCondition-Schnittstelle ab, die Inhaltselemente auswählt.
IUIAutomation::get_ContentViewWalker Ruft eine IUIAutomationTreeWalker-Schnittstelle ab, die zum Ermitteln von Inhaltselementen verwendet wird.
IUIAutomation::get_ControlViewCondition Ruft eine vordefinierte IUIAutomationCondition-Schnittstelle ab, die Steuerelementelemente auswählt.
IUIAutomation::get_ControlViewWalker Ruft eine IUIAutomationTreeWalker-Schnittstelle ab, die zum Ermitteln von Steuerelementelementen verwendet wird.
IUIAutomation::get_ProxyFactoryMapping Ruft ein -Objekt ab, das die Zuordnung von Window-Klassennamen und zugeordneten Daten zu einzelnen Proxyfactorys darstellt.
IUIAutomation::get_RawViewCondition Ruft eine vordefinierte IUIAutomationCondition-Schnittstelle ab, die alle UI-Elemente in einer ungefilterten Ansicht auswählt.
IUIAutomation::get_RawViewWalker Ruft ein Baumwandererobjekt ab, das zum Durchlaufen einer ungefilterten Ansicht der Microsoft Benutzeroberflächenautomatisierung-Struktur verwendet wird.
IUIAutomation::get_ReservedMixedAttributeValue Ruft ein statisches Tokenobjekt ab, das ein Text-Attribut darstellt, das ein gemischtes Attribut ist.
IUIAutomation::get_ReservedNotSupportedValue Ruft ein statisches Tokenobjekt ab, das ein Eigenschafts- oder Text-Attribut darstellt, das nicht unterstützt wird.
IUIAutomation::GetFocusedElement Ruft das Benutzeroberflächenautomatisierung-Element ab, das den Eingabefokus hat.
IUIAutomation::GetFocusedElementBuildCache Ruft das Benutzeroberflächenautomatisierung-Element ab, das den Eingabefokus hat, ruft die angeforderten Eigenschaften und Steuerelementmuster vorab ein und speichert die vorab abgerufenen Elemente im Cache.
IUIAutomation::GetPatternProgrammaticName Ruft den registrierten programmgesteuerten Namen eines Steuerelementmusters ab.
IUIAutomation::GetPropertyProgrammaticName Ruft den registrierten programmgesteuerten Namen einer Eigenschaft ab.
IUIAutomation::GetRootElement Ruft das Benutzeroberflächenautomatisierung-Element ab, das den Desktop darstellt.
IUIAutomation::GetRootElementBuildCache Ruft das Benutzeroberflächenautomatisierung-Element ab, das den Desktop darstellt, ruft die angeforderten Eigenschaften und Steuerelementmuster vorab ein und speichert die vorab abgerufenen Elemente im Cache.
IUIAutomation::IntNativeArrayToSafeArray Konvertiert ein Array von ganzen Zahlen in ein SAFEARRAY.
IUIAutomation::IntSafeArrayToNativeArray Konvertiert ein SAFEARRAY von ganzen Zahlen in ein Array.
IUIAutomation::P ollForPotentialSupportedPatterns Ruft die Steuerelementmuster ab, die für ein Benutzeroberflächenautomatisierung-Element möglicherweise unterstützt werden.
IUIAutomation::P ollForPotentialSupportedProperties Ruft die Eigenschaften ab, die für ein Benutzeroberflächenautomatisierung-Element möglicherweise unterstützt werden.
IUIAutomation::RectToVariant Erstellt einen VARIANT-Wert, der die Koordinaten eines Rechtecks enthält.
IUIAutomation::RemoveAllEventHandlers Entfernt alle registrierten Microsoft Benutzeroberflächenautomatisierung-Ereignishandler.
IUIAutomation::RemoveAutomationEventHandler Entfernt den angegebenen Benutzeroberflächenautomatisierung-Ereignishandler.
IUIAutomation::RemoveFocusChangedEventHandler Entfernt einen Fokusänderungs-Ereignishandler.
IUIAutomation::RemovePropertyChangedEventHandler Entfernt einen Eigenschaftsänderungs-Ereignishandler.
IUIAutomation::RemoveStructureChangedEventHandler Entfernt einen strukturveränderten Ereignishandler.
IUIAutomation::SafeArrayToRectNativeArray Konvertiert ein SAFEARRAY-Objekt, das Rechteckkoordinaten enthält, in ein Array vom Typ RECT.
IUIAutomation::VariantToRect Konvertiert einen VARIANT-Wert, der Rechteckkoordinaten enthält, in ein RECT.

Hinweise

Jede Benutzeroberflächenautomatisierung Clientanwendung muss diese Schnittstelle für ein CUIAutomation-Objekt abrufen, um Zugriff auf die Funktionalität von Benutzeroberflächenautomatisierung zu erhalten.

Die folgende Beispielfunktion erstellt ein CUIAutomation-Objekt und ruft die IUIAutomation-Schnittstelle ab.

IUIAutomation *g_pAutomation;

BOOL InitializeUIAutomation()
{
    CoInitialize(NULL);
    HRESULT hr = CoCreateInstance(__uuidof(CUIAutomation), NULL, CLSCTX_INPROC_SERVER, 
        __uuidof(IUIAutomation), (void**)&g_pAutomation);
    return (SUCCEEDED(hr));
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

Benutzeroberflächenautomatisierung-Elementschnittstellen für Clients