Noções básicas sobre o modelo de objeto de texto Automação da Interface do Usuário
Este tópico descreve como os aplicativos cliente do Microsoft Automação da Interface do Usuário acessam o conteúdo textual de um controle baseado em texto.
Os controles baseados em texto expõem conteúdo textual para Automação da Interface do Usuário aplicativos cliente por meio de um modelo de objeto de texto simples. Os aplicativos cliente têm acesso ao modelo de objeto de texto por meio das interfaces de padrão de controle Text e TextRange , incluindo IUIAutomationTextPattern e IUIAutomationTextRange. Os aplicativos cliente podem usar essas interfaces para recuperar conteúdo textual, atributos de texto e objetos inseridos, como tabelas e hiperlinks de controles baseados em texto.
Os tipos de controle que dão suporte ao modelo de objeto de texto Automação da Interface do Usuário incluem os tipos de controle Editar e Documento. Outros tipos de controle, como ToolTip e Text , também podem dar suporte ao modelo de objeto de texto, mas eles não são necessários.
Observação
O modelo de objeto de texto Automação da Interface do Usuário não fornece um meio de inserir ou modificar texto. No entanto, alguns controles permitem que o texto seja inserido ou modificado por meio da interface IUIAutomationValuePattern ou por meio da entrada direta do teclado.
Modelo de objeto específico do controle
Um controle baseado em texto que implementa seu próprio DOM (Modelo de Objeto de Documento) pode expor o DOM implementando o padrão de controle ObjectModel . Expor o DOM pode dar aos aplicativos cliente maior acesso e controle sobre o conteúdo de um controle baseado em texto.
Um aplicativo cliente pode descobrir se um controle baseado em texto específico implementa um DOM recuperando a interface IUIAutomationElement do controle. Em seguida, chame o método IUIAutomationElement::GetCurrentPropertyValue , especificando o identificador de propriedade UIA_IsObjectModelPatternAvailablePropertyId e uma variante que recebe TRUE se o controle implementa um DOM.
Para acessar o DOM, chame o método IUIAutomationElement::GetCurrentPattern , especificando o identificador de padrão de controle UIA_ObjectModelPatternId e uma variável que recebe a interface IUIAutomationObjectModelPattern . Chame o método IUIAutomationObjectModelPattern::GetUnderlyingObjectModel para recuperar a interface DOM.
Tópicos relacionados