Grundlegendes zum Benutzeroberflächenautomatisierung Textobjektmodell
In diesem Thema wird beschrieben, wie Microsoft Benutzeroberflächenautomatisierung 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 Hyperlinks aus textbasierten Steuerelementen abzurufen.
Steuerelementtypen, die das Benutzeroberflächenautomatisierung Textobjektmodell unterstützen, umfassen die Steuerelementtypen Edit und Document. Andere Steuerelementtypen wie QuickInfo und Text unterstützen möglicherweise auch das Textobjektmodell, sind jedoch nicht erforderlich.
Hinweis
Das Benutzeroberflächenautomatisierung Textobjektmodells bietet keine Möglichkeit zum Einfügen oder Ändern von Text. Einige Steuerelemente ermöglichen jedoch das Einfügen oder Ändern von Text über die IUIAutomationValuePattern-Schnittstelle oder über direkte Tastatureingaben.
Steuerelementspezifisches Objektmodell
Ein textbasiertes Steuerelement, das ein eigenes Document Object Model (DOM) implementiert, kann das DOM verfügbar machen, indem es das ObjectModel-Steuerelementmuster implementiert. Das Verfügbarmachen des DOM kann Clientanwendungen den Zugriff auf den Inhalt eines textbasierten Steuerelements und die Kontrolle darüber ermöglichen.
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, indem Sie den UIA_IsObjectModelPatternAvailablePropertyId Eigenschaftenbezeichner und eine Variante angeben, die TRUE empfängt, wenn das Steuerelement ein DOM implementiert.
Um auf das DOM zuzugreifen, rufen Sie die IUIAutomationElement::GetCurrentPattern-Methode auf, und geben Sie 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.
Zugehörige Themen