Grundlegendes zum Benutzeroberflächenautomatisierung Textobjektmodell
In diesem Thema wird beschrieben, Benutzeroberflächenautomatisierung Microsoft-Clientanwendungen auf den Textinhalt eines textbasierten Steuerelements zugreifen.
Textbasierte Steuerelemente machen Textinhalte für Benutzeroberflächenautomatisierung Clientanwendungen über ein einfaches Textobjektmodell verfügbar. Clientanwendungen haben Zugriff auf das Textobjektmodell über die Text- und TextRange-Steuerelementmusterschnittstellen, einschließlich IUIAutomationTextPattern und IUIAutomationTextRange. Clientanwendungen können diese Schnittstellen verwenden, um Textinhalte, Textattribute und eingebettete Objekte wie Tabellen und Links aus textbasierten Steuerelementen abzurufen.
Steuerelementtypen, die das Benutzeroberflächenautomatisierung-Textobjektmodell unterstützen, umfassen die Steuerelementtypen Bearbeiten und Dokument. Andere Steuerelementtypen wie QuickInfo und Text unterstützen möglicherweise auch das Textobjektmodell, dies ist jedoch nicht erforderlich.
Hinweis
Das Benutzeroberflächenautomatisierung Textobjektmodell bietet keine Möglichkeit zum Einfügen oder Ändern von Text. Einige Steuerelemente ermöglichen jedoch das Einfügen oder Ändern von Text entweder über die IUIAutomationValuePattern-Schnittstelle oder über direkte Tastatureingaben.
Steuerelementspezifisches Objektmodell
Ein textbasiertes Steuerelement, das ein eigenes Dokumentobjektmodell (DOM) implementiert, kann das DOM verfügbar machen, indem es das ObjectModel-Steuerelementmuster implementiert. Durch das Verfügbar machen des DOM können Clientanwendungen besseren Zugriff auf den Inhalt eines textbasierten Steuerelements erhalten und diesen steuern.
Eine Clientanwendung kann ermitteln, ob ein bestimmtes textbasiertes Steuerelement ein DOM implementiert, indem die IUIAutomationElement-Schnittstelle des Steuerelements abgerufen wird. Rufen Sie dann die IUIAutomationElement::GetCurrentPropertyValue-Methode auf, und geben Sie dabei den _ UIA-Eigenschaftenbezeichner IsObjectModelPatternAvailablePropertyId und eine Variante an, die TRUE empfängt, wenn das Steuerelement ein DOM implementiert.
Rufen Sie für den Zugriff auf das DOM die IUIAutomationElement::GetCurrentPattern-Methode auf, und geben Sie dabei den UIA _ ObjectModelPatternId-Steuerelementmusterbezeichner und eine Variable an, die die IUIAutomationObjectModelPattern-Schnittstelle empfängt. Rufen Sie die IUIAutomationObjectModelPattern::GetUnderlyingObjectModel-Methode auf, um die DOM-Schnittstelle abzurufen.