Freigeben über


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