Informatie over het UI Automation Text Object Model
In dit onderwerp wordt beschreven hoe Microsoft UI Automation-cliënttoepassingen toegang krijgen tot de tekstinhoud van een op tekst gebaseerd besturingselement.
Besturingselementen op basis van tekst maken tekstuele inhoud beschikbaar voor UI Automation-clienttoepassingen via een eenvoudig tekstobjectmodel. Clienttoepassingen hebben toegang tot het tekstobjectmodel via de Text- en TextRange besturingspatrooninterfaces, waaronder IUIAutomationTextPattern- en IUIAutomationTextRange. Clienttoepassingen kunnen deze interfaces gebruiken om tekstuele inhoud, tekstkenmerken en ingesloten objecten zoals tabellen en hyperlinks op te halen uit besturingselementen op basis van tekst.
Bedieningselementtypen die ondersteuning bieden voor het UI Automation-objectmodel zijn zoals de Bewerken en Document besturingstypen. Andere besturingstypen, zoals ToolTip en Text, ondersteunen mogelijk ook het tekstobjectmodel, maar dat is niet vereist.
Notitie
Het objectmodel van ui Automation-tekst biedt geen methode om tekst in te voegen of te wijzigen. Met sommige besturingselementen kan echter tekst worden ingevoegd of gewijzigd, hetzij via de IUIAutomationValuePattern interface, hetzij via directe toetsenbordinvoer.
Objectmodel specifiek voor het besturingselement
Een op tekst gebaseerd besturingselement dat een eigen DOM (Document Object Model) implementeert, kan de DOM beschikbaar maken door het ObjectModel besturingspatroon te implementeren. Het beschikbaar maken van de DOM kan clienttoepassingen meer toegang geven tot en controle over de inhoud van een op tekst gebaseerd besturingselement.
Een clienttoepassing kan ontdekken of een tekstgebaseerd besturingselement een DOM implementeert door de interface van het besturingselement IUIAutomationElement op te halen. Roep vervolgens de methode IUIAutomationElement::GetCurrentPropertyValue aan, waarbij de eigenschaps-id UIA_IsObjectModelPatternAvailablePropertyId wordt opgegeven, en een variant die TRUE ontvangt als het besturingselement een DOM implementeert.
Als u toegang wilt krijgen tot de DOM, roept u de IUIAutomationElement::GetCurrentPattern methode aan, waarbij u de UIA_ObjectModelPatternId patroon-id en een variabele opgeeft die de IUIAutomationObjectModelPattern interface ontvangt. Roep de methode IUIAutomationObjectModelPattern::GetUnderlyingObjectModel methode aan om de DOM-interface op te halen.
Verwante onderwerpen