Identificadores de propriedade de elemento de automação

Este tópico descreve as constantes nomeadas que identificam as propriedades dos elementos da Automação da Interface do Usuário da Microsoft.

Constante/valor Descrição
UIA_AcceleratorKeyPropertyId
30006
Identifica a propriedade AcceleratorKey , que é uma cadeia de caracteres que contém as combinações de tecla de acelerador (também chamada de tecla de atalho) para o elemento de automação.
Combinações de teclas de atalho invocam uma ação. Por exemplo, CTRL+O geralmente é usado para invocar a caixa de diálogo Abrir arquivo comum. Um elemento de automação que tem a propriedade AcceleratorKey pode implementar o padrão de controle Invoke para a ação equivalente ao comando de atalho.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_AccessKeyPropertyId
30007
Identifica a propriedade AccessKey , que é uma cadeia de caracteres que contém o caractere de chave de acesso para o elemento de automação.
Uma tecla de acesso (às vezes chamada de mnemônico) é um caractere no texto de um menu, item de menu ou rótulo de um controle, como um botão, que ativa a função de menu associada. Por exemplo, para abrir o menu Arquivo, para o qual a tecla de acesso normalmente é F, o usuário pressionaria ALT+F.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_AnnotationObjectsPropertyId
30156
Identifica a propriedade AnnotationObjects , que é uma lista de objetos de anotação em um documento, como comentário, cabeçalho, rodapé e assim por diante.
Tipo variante: VT_I4 | VT_ARRAY
Valor padrão: matriz vazia
UIA_AnnotationTypesPropertyId
30155
Identifica a propriedade AnnotationTypes , que é uma lista dos tipos de anotações em um documento, como comentário, cabeçalho, rodapé e assim por diante.
Tipo variante: VT_I4 | VT_ARRAY
Valor padrão: matriz vazia
UIA_AriaPropertiesPropertyId
30102
Identifica a propriedade AriaProperties , que é uma cadeia de caracteres formatada que contém as informações da propriedade ARIA (Accessible Rich Internet Application) para o elemento de automação. Para obter mais informações sobre como mapear estados e propriedades do ARIA para propriedades e funções da Automação da Interface do Usuário, consulte Automação da Interface do Usuário para Especificação de Aplicativos de Internet Avançados Acessíveis W3C.
AriaProperties é uma coleção de pares Nome/Valor com delimitadores de = (igual a) e ; (ponto e vírgula), por exemplo, "checked=true;disabled=false". O \ (barra invertida) é usado como um caractere de escape quando esses caracteres delimitadores ou \ aparecem nos valores. Por motivos de segurança e outros motivos, a implementação do provedor dessa propriedade pode tomar medidas para validar as propriedades originais do ARIA; no entanto, não é necessário.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_AriaRolePropertyId
30101
Identifica a propriedade AriaRole , que é uma cadeia de caracteres que contém as informações da função ARIA (Aplicativo de Internet Avançada Acessível) para o elemento de automação. Para obter mais informações sobre como mapear funções ARIA para tipos de controle de Automação da Interface do Usuário, consulte Automação da Interface do Usuário para Especificação de Aplicativos de Internet Avançados Acessíveis W3C.

Observação:
Como opção, o agente do usuário também pode oferecer uma descrição localizada da função W3C ARIA na propriedade LocalizedControlType . Quando a cadeia de caracteres localizada não for especificada, o sistema fornecerá a cadeia de caracteres LocalizedControlType padrão para o elemento.



Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia

UIA_AutomationIdPropertyId
30011
Identifica a propriedade AutomationId , que é uma cadeia de caracteres que contém o ID (identificador de Automação da Interface do Usuário) para o elemento de automação.
Quando ele está disponível, a AutomationId de um elemento deve ser a mesma em qualquer instância do aplicativo, independentemente do idioma local. O valor deve ser exclusivo entre elementos irmãos, mas não necessariamente exclusivo em toda a área de trabalho. Por exemplo, várias instâncias de um aplicativo ou várias exibições de pasta no Microsoft Windows Explorer, podem conter elementos com a mesma propriedade AutomationId, como "SystemMenuBar".
Embora o suporte para AutomationId seja sempre recomendado para um melhor suporte a testes automatizados, essa propriedade não é obrigatória. Quando há suporte, AutomationId é útil para criar um script de automação de teste que é executado independentemente da linguagem da interface do usuário. Os clientes não devem fazer suposições sobre os valores automationId expostos por outros aplicativos. Não há garantia de que AutomationId seja estável em diferentes versões ou builds de um aplicativo.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_BoundingRectanglePropertyId
30001
Identifica a propriedade BoundingRectangle , que especifica as coordenadas do retângulo que inclui completamente o elemento de automação. O retângulo é expresso em coordenadas de tela físicas. Ele pode conter pontos que não podem ser clicados se a forma ou a região clicável do item de interface do usuário estiver irregular ou se o item for obscurecido por outros elementos da interface do usuário.
Tipo de variante: VT_R8 | VT_ARRAY
Valor padrão: [0,0,0,0]

Observação:
Essa propriedade será NULL se o item não estiver exibindo uma interface do usuário no momento.



UIA_CenterPointPropertyId
30165
Identifica a propriedade CenterPoint , que especifica as coordenadas de ponto X e Y central do elemento de automação. O espaço de coordenadas é o que o provedor considera logicamente uma página.
Tipo de variante: VT_R8 | VT_ARRAY
Valor padrão: VT_EMPTY
UIA_ClassNamePropertyId
30012
Identifica a propriedade ClassName , que é uma cadeia de caracteres que contém o nome da classe para o elemento de automação, conforme atribuído pelo desenvolvedor de controle.
O nome da classe depende da implementação do provedor de Automação da Interface do Usuário e, portanto, nem sempre está em um formato padrão. No entanto, se o nome da classe for conhecido, ele poderá ser usado para verificar se um aplicativo está trabalhando com o elemento de automação esperado.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_ClickablePointPropertyId
30014
Identifica a propriedade ClickablePoint , que é um ponto no elemento de automação que pode ser clicado. Um elemento não poderá ser clicado se estiver completamente ou parcialmente obscurecido por outra janela.
Tipo de variante: VT_R8 | VT_ARRAY
Valor padrão: VT_EMPTY
UIA_ControllerForPropertyId
30104
Identifica a propriedade ControllerFor , que é uma matriz de elementos de automação que são manipulados pelo elemento de automação que dá suporte a essa propriedade.
ControllerFor é usado quando um elemento de automação afeta um ou mais segmentos da interface do usuário do aplicativo ou da área de trabalho; caso contrário, é difícil associar o impacto da operação de controle aos elementos da interface do usuário.
Esse identificador é comumente usado para a acessibilidade de sugestão automática.
Tipo variante para provedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray )
Valor padrão: matriz vazia
UIA_ControlTypePropertyId
30003
Identifica a propriedade ControlType , que é uma classe que identifica o tipo do elemento de automação. ControlType define características dos elementos da interface do usuário por primitivos de controle de interface do usuário conhecidos, como botão ou caixa de marcar.
Tipo de variante: VT_I4
Valor padrão: UIA_CustomControlTypeId

Observação:
Use o valor padrão somente se o elemento de automação representar um tipo completamente novo de controle.



UIA_CulturePropertyId
30015
Identifica a propriedade Culture, que contém um identificador de localidade para o elemento de automação (por exemplo, 0x0409 para "en-US" ou inglês (Estados Unidos)).
Cada localidade tem um identificador exclusivo, um valor de 32 bits que consiste em um identificador de linguagem e um identificador de ordem de classificação. O identificador de localidade é uma abreviação numérica internacional padrão e tem os componentes necessários para identificar exclusivamente uma das localidades definidas pelo sistema operacional instaladas. Para obter mais informações, consulte Constantes e cadeias de caracteres do identificador de idioma.
Essa propriedade pode existir por controle, mas normalmente só está disponível em um nível de aplicativo.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_DescribedByPropertyId
30105
Identifica a propriedade DescribedBy , que é uma matriz de elementos que fornecem mais informações sobre o elemento de automação.
DescribedBy é usado quando um elemento de automação é explicado por outro segmento da interface do usuário do aplicativo. Por exemplo, a propriedade pode apontar para um elemento de texto de "2.529 itens em 85 grupos, 10 itens selecionados" de um objeto de lista personalizado complexo. Em vez de usar o modelo de objeto para os clientes digerirem informações semelhantes, a propriedade DescribedBy pode oferecer acesso rápido ao elemento de interface do usuário que já pode oferecer informações úteis do usuário final que descrevem o elemento de interface do usuário.
Tipo de variante para provedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor padrão: matriz vazia
UIA_FillColorPropertyId
30160
Identifica a propriedade FillColor , que especifica a cor usada para preencher o elemento de automação. Esse atributo é especificado como UM COLORREF, um valor de 32 bits usado para especificar uma cor RGB ou RGBA.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_FillTypePropertyId
30162
Identifica a propriedade FillType , que especifica o padrão usado para preencher o elemento de automação, como nenhum, cor, gradiente, imagem, padrão e assim por diante.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_FlowsFromPropertyId
30148
Identifica a propriedade FlowsFrom , que é uma matriz de elementos de automação que sugere a ordem de leitura antes do elemento de automação atual. Com suporte a partir do Windows 8.
A propriedade FlowsFrom especifica a ordem de leitura quando os elementos de automação não são expostos ou estruturados na mesma ordem de leitura percebida pelo usuário. Embora a propriedade FlowsFrom possa especificar vários elementos anteriores, ela normalmente contém apenas o elemento anterior na ordem de leitura.
Tipo de variante para provedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor padrão: matriz vazia
UIA_FlowsToPropertyId
30106
Identifica a propriedade FlowsTo , que é uma matriz de elementos de automação que sugere a ordem de leitura após o elemento de automação atual.
A propriedade FlowsTo especifica a ordem de leitura quando os elementos de automação não são expostos ou estruturados na mesma ordem de leitura percebida pelo usuário. Embora a propriedade FlowsTo possa especificar vários elementos bem-sucedidos, ela normalmente contém apenas o próximo elemento na ordem de leitura.
Tipo de variante para provedores: VT_UNKNOWN | VT_ARRAY
Tipo de variante para clientes: VT_UNKNOWN (IUIAutomationElementArray)
Valor padrão: matriz vazia
UIA_FrameworkIdPropertyId
30024
Identifica a propriedade FrameworkId , que é uma cadeia de caracteres que contém o nome da estrutura de interface do usuário subjacente à qual o elemento de automação pertence.
A FrameworkId permite que os aplicativos cliente processem elementos de automação de forma diferente, dependendo da estrutura de interface do usuário específica. Exemplos de valores de propriedade incluem "Win32", "WinForm" e "DirectUI".
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_FullDescriptionPropertyId
30159
A propriedade FullDescription expõe uma cadeia de caracteres localizada que pode conter texto de descrição estendido para um elemento. FullDescription pode conter uma descrição mais completa de um elemento do que pode ser apropriado para o nome do elemento.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_HasKeyboardFocusPropertyId
30008
Identifica a propriedade HasKeyboardFocus , que é um valor booliano que indica se o elemento de automação tem foco no teclado.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_HeadingLevelPropertyId
30173
Identifica a propriedade HeadingLevel , que indica o nível de título de um elemento de Automação da Interface do Usuário.
Tipo de variante: VT_I4
Valor padrão: HeadingLevel_None
UIA_HelpTextPropertyId
30013
Identifica a propriedade HelpText , que é uma cadeia de caracteres de texto de ajuda associada ao elemento de automação.
A propriedade HelpText pode ter suporte com texto de espaço reservado aparecendo em controles de edição ou lista. Por exemplo, "Digite texto aqui para pesquisa" é um bom candidato à propriedade HelpText para um controle de edição que coloca o texto antes da entrada real do usuário. No entanto, ele não é adequado para a propriedade name do controle de edição.
Quando o HelpText tem suporte, a cadeia de caracteres deve corresponder ao idioma da interface do usuário do aplicativo ou à linguagem de interface do usuário padrão do sistema operacional.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_IsContentElementPropertyId
30017
Identifica a propriedade IsContentElement , que é um valor booliano que especifica se o elemento aparece na exibição de conteúdo da árvore de elementos de automação. Para obter mais informações, consulte Visão geral da árvore de automação da interface do usuário.

Observação:
Para que um elemento apareça na exibição de conteúdo, a propriedade IsContentElement e a propriedade IsControlElement devem ser TRUE.



Tipo de variante: VT_BOOL
Valor padrão: TRUE

UIA_IsControlElementPropertyId
30016
Identifica a propriedade IsControlElement , que é um valor booliano que especifica se o elemento aparece na exibição de controle da árvore de elementos de automação. Para obter mais informações, consulte Visão geral da árvore de automação da interface do usuário.
Tipo de variante: VT_BOOL
Valor padrão: TRUE
UIA_IsDataValidForFormPropertyId
30103
Identifica a propriedade IsDataValidForForm , que é um valor booliano que indica se o valor inserido ou selecionado é válido para a regra de formulário associada ao elemento de automação. Por exemplo, se o usuário inseriu "425-555-5555" para um campo de cep que requer 5 ou 9 dígitos, a propriedade IsDataValidForForm pode ser definida como FALSE para indicar que os dados não são válidos.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsDialogPropertyId
30174
Identifica a propriedade IsDialog , que é um valor booliano que indica se o elemento de automação é uma janela de diálogo. Por exemplo, tecnologia adaptativa, como leitores de tela, normalmente falam o título da caixa de diálogo, o controle focalizado na caixa de diálogo e, em seguida, o conteúdo da caixa de diálogo até o controle focalizado ("Deseja salvar suas alterações antes de fechar"). Para janelas padrão, um leitor de tela normalmente fala o título da janela seguido pelo controle focalizado. A propriedade IsDialog pode ser definida como TRUE para indicar que o aplicativo cliente deve tratar o elemento como uma janela de diálogo.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsEnabledPropertyId
30010
Identifica a propriedade IsEnabled , que é um valor booliano que indica se o item de interface do usuário referenciado pelo elemento de automação está habilitado e pode ser interagido.
Quando o estado habilitado de um controle é FALSE, supõe-se que os controles filho também não estão habilitados. Os clientes não devem esperar eventos alterados por propriedade de elementos filho quando o estado do controle pai for alterado.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsKeyboardFocusablePropertyId
30009
Identifica a propriedade IsKeyboardFocusable , que é um valor booliano que indica se o elemento de automação pode aceitar o foco do teclado.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsOffscreenPropertyId
30022
Identifica a propriedade IsOffscreen , que é um valor booliano que indica se o elemento de automação é totalmente rolado para fora da exibição (por exemplo, um item em uma caixa de listagem que está fora do visor do objeto contêiner) ou recolhido fora da exibição (por exemplo, um item em um modo de exibição de árvore ou menu ou em uma janela minimizada). Se o elemento tiver um ponto clicável que possa fazer com que ele receba o foco, o elemento será considerado na tela enquanto uma parte do elemento estiver fora da tela.
O valor da propriedade não é afetado pela oclusão por outras janelas ou se o elemento está visível em um monitor específico.
Se a propriedade IsOffscreen for TRUE, o elemento de interface do usuário será rolado para fora da tela ou recolhido. O elemento está temporariamente oculto, mas permanece na percepção do usuário final e continua sendo incluído no modelo de interface do usuário. O objeto pode ser colocado novamente em exibição rolando, clicando em uma lista suspensa e assim por diante.
Objetos que o usuário final não percebe ou que estão "ocultas programaticamente" (por exemplo, uma caixa de diálogo que foi ignorada, mas o objeto subjacente ainda é armazenado em cache pelo aplicativo) não devem estar na árvore de elementos de automação em primeiro lugar (em vez de definir o estado de IsOffscreen como TRUE).
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsPasswordPropertyId
30019
Identifica a propriedade IsPassword , que é um valor booliano que indica se o elemento de automação contém conteúdo protegido ou uma senha.
Quando a propriedade IsPassword é TRUE e o elemento tem o foco do teclado, um aplicativo cliente deve desabilitar o eco de teclado ou comentários de entrada do teclado que possam expor as informações protegidas do usuário. A tentativa de acessar a propriedade Value do elemento protegido (controle de edição) pode causar um erro.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsPeripheralPropertyId
30150
Identifica a propriedade IsPeripheral , que é um valor booliano que indica se o elemento de automação representa a interface do usuário periférica. A interface do usuário periférica é exibida e dá suporte à interação do usuário, mas não assume o foco do teclado quando é exibida. Exemplos de interface do usuário periférica incluem pop-ups, submenus, menus de contexto ou notificações flutuantes. Suporte começando com Windows 8.1.
Quando a propriedade IsPeripheral é TRUE, um aplicativo cliente não pode assumir que o foco foi tirado pelo elemento, mesmo que ele esteja atualmente interativo por teclado.
Essa propriedade é relevante para estes tipos de controle:
  • UIA_GroupControlTypeId
  • UIA_MenuControlTypeId
  • UIA_PaneControlTypeId
  • UIA_ToolBarControlTypeId
  • UIA_ToolTipControlTypeId
  • UIA_WindowControlTypeId
  • UIA_CustomControlTypeId
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_IsRequiredForFormPropertyId
30025
Identifica a propriedade IsRequiredForForm , que é um valor booliano que indica se o elemento de automação deve ser preenchido em um formulário.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_ItemStatusPropertyId
30026
Identifica a propriedade ItemStatus, que é uma cadeia de caracteres de texto que descreve a status de um item do elemento de automação.
ItemStatus permite que um cliente verifique se um elemento está transmitindo status sobre um item, bem como qual é o status. Por exemplo, um item associado a um contato em um aplicativo de mensagens pode ser "Ocupado" ou "Conectado".
Quando há suporte para ItemStatus , a cadeia de caracteres deve corresponder ao idioma da interface do usuário do aplicativo ou ao idioma da interface do usuário padrão do sistema operacional.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_ItemTypePropertyId
300021
Identifica a propriedade ItemType , que é uma cadeia de caracteres de texto que descreve o tipo do elemento de automação.
ItemType é usado para obter informações sobre itens em uma lista, exibição de árvore ou grade de dados. Por exemplo, um item em um modo de exibição de diretório de arquivos pode ser um "Arquivo de Documento" ou uma "Pasta".
Quando há suporte para ItemType , a cadeia de caracteres deve corresponder ao idioma da interface do usuário do aplicativo ou ao idioma da interface do usuário padrão do sistema operacional.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_LabeledByPropertyId
30018
Identifica a propriedade LabeledBy , que é um elemento de automação que contém o rótulo de texto para esse elemento.
Essa propriedade pode ser usada para recuperar, por exemplo, o rótulo de texto estático para uma caixa de combinação.
Tipo de variante: VT_UNKNOWN
Valor padrão: NULL
UIA_LandmarkTypePropertyId
30157
Identifica a propriedade LandmarkType , que é um Identificador de Tipo de Ponto de Referência associado a um elemento .
A propriedade LandmarkType descreve um elemento que representa um grupo de elementos. Por exemplo, um ponto de referência de pesquisa pode representar um conjunto de controles relacionados para pesquisa.
Se UIA_CustomLandmarkTypeId for usado , UIA_LocalizedLandmarkTypePropertyId será necessário para descrever o ponto de referência personalizado.
Tipo variante: VT_I4
Valor Padrão: 0
UIA_LevelPropertyId
30154
Identifica a propriedade Level , que é um inteiro baseado em 1 associado a um elemento de automação.
A propriedade Level descreve o local de um elemento dentro de estruturas hierárquicas hierárquicas ou quebradas. Por exemplo, uma lista numerada/com marcadores, títulos ou outros itens de dados estruturados podem ter várias relações pai/filho. Level descreve onde na estrutura o item está localizado.
É recomendável usar o padrão de controle CustomNavigation em conjunto com Level.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_LiveSettingPropertyId
30135
Identifica a propriedade LiveSetting , que é compatível com um elemento de automação que representa uma região dinâmica. A propriedade LiveSetting indica o nível de "educação" que um cliente deve usar para notificar o usuário sobre as alterações na região dinâmica. Essa propriedade pode ser um dos valores da enumeração LiveSetting . Com suporte a partir do Windows 8.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_LocalizedControlTypePropertyId
30004
Identifica a propriedade LocalizedControlType , que é uma cadeia de texto que descreve o tipo de controle que o elemento de automação representa. A cadeia de caracteres deve conter apenas caracteres minúsculos:
  • Correto: "button"
  • Incorreto: "Button"

Quando LocalizedControlType não é especificado pelo provedor de elementos, a cadeia de caracteres localizada padrão é fornecida pela estrutura, de acordo com o tipo de controle do elemento (por exemplo, "button" para o tipo de controle Button ). Um elemento de automação com o tipo de controle Personalizado deve dar suporte a uma cadeia de caracteres de tipo de controle localizada que representa a função do elemento (por exemplo, "seletor de cores" para um controle personalizado que permite que os usuários escolham e especifiquem cores).
Quando um valor personalizado é fornecido, a cadeia de caracteres deve corresponder ao idioma da interface do usuário do aplicativo ou à linguagem de interface do usuário padrão do sistema operacional.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_LocalizedLandmarkTypePropertyId
30158
Identifica o LocalizedLandmarkType, que é uma cadeia de caracteres de texto que descreve o tipo de ponto de referência que o elemento de automação representa.
Isso deve ser usado em conjunto com UIA_CustomLandmarkTypeId no entanto, LocalizedLandmarkType sempre deve ter precedência sobre LandmarkType e ser usado para descrever o ponto de referência antes de LandmarkType.
A cadeia de caracteres deve corresponder ao idioma da interface do usuário do aplicativo ou à linguagem de interface do usuário padrão do sistema operacional.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_NamePropertyId
30005
Identifica a propriedade Name , que é uma cadeia de caracteres que contém o nome do elemento de automação.
A propriedade Name deve ser igual ao texto do rótulo na tela. Por exemplo, Name deve ser "Procurar" para um elemento de botão com o rótulo "Procurar". A propriedade Name não deve incluir o caractere mnemônico para as chaves de acesso (ou seja, "&"), que é sublinhado na apresentação de texto da interface do usuário. Além disso, a propriedade Name não deve ser uma versão estendida ou modificada do rótulo na tela porque a inconsistência entre o nome e o rótulo pode causar confusão entre aplicativos cliente e usuários.
Quando o texto do rótulo correspondente não estiver visível na tela ou quando for substituído por elementos gráficos, o texto alternativo deverá ser escolhido. O texto alternativo deve ser conciso, intuitivo e localizado para o idioma da interface do usuário do aplicativo ou para a linguagem de interface do usuário padrão do sistema operacional. O texto alternativo não deve ser uma descrição detalhada dos detalhes visuais, mas uma descrição concisa da função ou recurso da interface do usuário como se tivesse sido rotulado por texto simples. Por exemplo, o botão de menu Iniciar do Windows é chamado de "Iniciar" (botão) em vez de "Logotipo do Windows em elementos gráficos de esfera redonda azul" (botão). Para obter mais informações, consulte Criando equivalentes de texto para imagens.
Quando um rótulo de interface do usuário usa gráficos de texto (por exemplo, usando ">>" para um botão que adiciona um item da esquerda para a direita), a propriedade Name deve ser substituída por uma alternativa de texto apropriada (por exemplo, "Adicionar"). No entanto, a prática de usar elementos gráficos de texto como um rótulo de interface do usuário é desencorajada devido a preocupações de localização e acessibilidade.
A propriedade Name não deve incluir a função de controle ou as informações de tipo, como "button" ou "list"; caso contrário, ele entrará em conflito com o texto da propriedade LocalizedControlType quando essas duas propriedades forem acrescentadas (muitas tecnologias adaptativas existentes fazem isso).
A propriedade Name não pode ser usada como um identificador exclusivo entre irmãos. No entanto, desde que seja consistente com a apresentação da interface do usuário, o mesmo valor de Nome pode ser suportado entre pares. Para a automação de teste, os clientes devem considerar o uso da propriedade AutomationId ou RuntimeId .
Os controles de texto nem sempre precisam fazer com que a propriedade Name seja idêntica ao texto exibido dentro do controle, desde que o padrão Text também tenha suporte.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_NativeWindowHandlePropertyId
30020
Identifica a propriedade NativeWindowHandle , que é um inteiro que representa o identificador (HWND) da janela do elemento de automação, se existir; caso contrário, essa propriedade será 0.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_OptimizeForVisualContentPropertyId
30111
Identifica a propriedade OptimizeForVisualContent , que é um valor booliano que indica se o provedor expõe apenas elementos visíveis. Um provedor pode usar essa propriedade para otimizar o desempenho ao trabalhar com partes muito grandes de conteúdo. Por exemplo, como o usuário usa páginas por meio de uma grande parte do conteúdo, o provedor pode destruir elementos de conteúdo que não estão mais visíveis. Quando um elemento de conteúdo é destruído, o provedor deve retornar o código de erro UIA_E_ELEMENTNOTAVAILABLE . Com suporte a partir do Windows 8.
Tipo de variante: VT_BOOL
Valor padrão: FALSE
UIA_OrientationPropertyId
300023
Identifica a propriedade Orientation , que indica a orientação do controle representado pelo elemento de automação. A propriedade é expressa como um valor do tipo enumerado OrientationType .
A propriedade Orientation é compatível com controles, como barras de rolagem e controles deslizantes, que podem ter uma orientação vertical ou horizontal. Caso contrário, ele sempre pode ser OrientationType_None, o que significa que o controle não tem orientação.
Tipo de variante: VT_I4
Valor padrão: 0 (OrientationType_None)
UIA_OutlineColorPropertyId
30161
Identifica a propriedade OutlineColor , que especifica a cor usada para a estrutura de tópicos do elemento de automação. Esse atributo é especificado como UM COLORREF, um valor de 32 bits usado para especificar uma cor RGB ou RGBA.
Tipo de variante: VT_I4 | VT_ARRAY
Valor padrão: 0
UIA_OutlineThicknessPropertyId
30164
Identifica a propriedade OutlineThickness , que especifica a largura da estrutura de tópicos do elemento de automação.
Tipo de variante: VT_R8 | VT_ARRAY
Valor padrão: VT_EMPTY
UIA_PositionInSetPropertyId
30152
Identifica a propriedade PositionInSet , que é um inteiro baseado em 1 associado a um elemento de automação. PositionInSet descreve o local ordinal do elemento dentro de um conjunto de elementos que são considerados irmãos.
PositionInSet funciona em coordenação com a propriedade SizeOfSet para descrever o local ordinal no conjunto.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_ProcessIdPropertyId
30002
Identifica a propriedade ProcessId , que é um inteiro que representa o identificador de processo (ID) do elemento de automação.
O identificador de processo (ID) é atribuído pelo sistema operacional. Ele pode ser visto na coluna PID da guia Processos no Gerenciador de Tarefas .
Tipo de variante: VT_I4
Valor padrão: 0
UIA_ProviderDescriptionPropertyId
30107
Identifica a propriedade ProviderDescription , que é uma cadeia de caracteres formatada que contém as informações de origem do provedor de Automação da Interface do Usuário para o elemento de automação, incluindo informações de proxy.
Tipo de variante: VT_BSTR
O valor padrão: cadeia de caracteres vazia
UIA_RotationPropertyId
30166
Identifica a propriedade Rotation , que especifica o ângulo de rotação em unidades não especificadas.
Tipo de variante: VT_R8
Valor padrão: 0
UIA_RuntimeIdPropertyId
30000
Identifica a propriedade RuntimeId , que é uma matriz de inteiros que representa o identificador de um elemento de automação.
O identificador é exclusivo na área de trabalho, mas é garantido que ele seja exclusivo somente dentro da interface do usuário da área de trabalho na qual foi gerado. Os identificadores podem ser reutilizados ao longo do tempo.
O formato de RuntimeId pode ser alterado. O identificador retornado deve ser tratado como um valor opaco e usado apenas para comparação; por exemplo, para determinar se um elemento de automação está no cache.
Tipo de variante: VT_I4 | VT_ARRAY
Valor padrão: VT_EMPTY
UIA_SizePropertyId
30167
Identifica a propriedade Size , que especifica a largura e a altura do elemento de automação.
Tipo de variante: VT_R8 | VT_ARRAY
Valor padrão: VT_EMPTY
UIA_SizeOfSetPropertyId
30153
Identifica a propriedade SizeOfSet , que é um inteiro baseado em 1 associado a um elemento de automação. SizeOfSet descreve a contagem de elementos de automação em um grupo ou conjunto que são considerados irmãos.
SizeOfSet funciona em coordenação com a propriedade PositionInSet para descrever a contagem de itens no conjunto.
Tipo de variante: VT_I4
Valor padrão: 0
UIA_VisualEffectsPropertyId
30163
Identifica a propriedade VisualEffects , que é um campo de bits que especifica efeitos no elemento de automação, como sombra, reflexão, brilho, bordas suaves ou bisel.
VisualEffects:
  • VisualEffects_Shadow: 0x1
  • VisualEffects_Reflection: 0x2
  • VisualEffects_Glow: 0x4
  • VisualEffects_SoftEdges: 0x8
  • VisualEffects_Bevel: 0x10
Tipo de variante: VT_I4
Valor padrão: 0

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte
Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
parâmetro
UIAutomationClient.h

Confira também

Conceitual

Visão geral das propriedades de automação da interface do usuário

Recuperando propriedades de elementos de automação da interface do usuário