Tipo de controle ListItem
Este tópico fornece informações sobre o suporte de automação da interface do usuário da Microsoft para o tipo de controle ListItem.
Os controles de item de lista são um exemplo de controles que implementam o tipo de controle ListItem.
As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle ListItem. Os requisitos de automação da interface do usuário se aplicam a todos os controles de item de lista em que a estrutura/plataforma da interface do usuário integra o suporte à automação da interface do usuário para tipos de controle e padrões de controle.
Este tópico contém as seguintes seções.
- estrutura típica da árvore
- Propriedades relevantes
- padrões de controle necessários
- Eventos necessários
- Observações
- Tópicos relacionados
Estrutura típica da árvore
A tabela a seguir descreve um controle típico e uma exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles de item de lista e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de automação da interface do usuário, consulte Visão geral da árvore de automação da interface do usuário .
| Vista de Controlo | Visualização de conteúdo |
|---|---|
|
|
Os filhos de um controle de item de lista na exibição de conteúdo da árvore de Automação da Interface do Usuário sempre devem mostrar zero filhos. Se a estrutura do controle for tal que outros itens estejam contidos abaixo do item de lista, ele deverá seguir os requisitos para o suporte de automação da interface do usuário para o tipo de controle TreeItem.
Propriedades relevantes
A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para o tipo de controle ListItem. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.
| Propriedade de automação da interface do usuário | Valor | Observações |
|---|---|---|
| UIA_AutomationIdPropertyId | Ver notas. | O valor dessa propriedade deve ser exclusivo entre todos os elementos de mesmo nível na exibição bruta da árvore de Automação da Interface do Usuário. Aloque a propriedade AutomationId para um item de lista se o elemento for conhecido por ser consistente em diferentes instâncias da interface do usuário. Se o item de lista for preenchido dinamicamente e não for previsível, deixe a propriedade AutomationId em branco. |
| UIA_BoundingRectanglePropertyId | Ver notas. | Esse valor dessa propriedade deve incluir a área do conteúdo da imagem e do texto do item de lista. |
| UIA_ClickablePointPropertyId | Depende | Se o controle de lista tiver um ponto clicável (um ponto que pode ser clicado para fazer com que a lista tome foco), esse ponto deve ser exposto por meio dessa propriedade. Se o controle de lista estiver completamente coberto por itens de lista descendentes, ele retornará o erro de UIA_E_NOCLICKABLEPOINT para indicar que o cliente deve solicitar um item dentro do controle de lista para um ponto clicável. |
| UIA_ControlTypePropertyId | ListItem | Esse valor é o mesmo para todas as estruturas de interface do usuário. |
| UIA_HelpTextPropertyId | Ver notas. | O texto da Ajuda para controles de lista deve explicar por que o usuário está sendo solicitado a fazer uma escolha a partir de uma lista de opções, que normalmente é o mesmo tipo de informação apresentada por meio de uma dica de ferramenta. Por exemplo, "Selecione um item para definir a resolução de exibição para o monitor". |
| UIA_IsContentElementPropertyId | VERDADEIRO | O controle de lista é sempre incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário. |
| UIA_IsControlElementPropertyId | VERDADEIRO | O controle de lista é sempre incluído na exibição de controle da árvore de Automação da Interface do Usuário. |
| UIA_IsKeyboardFocusablePropertyId | Ver notas. | Se o contêiner puder aceitar a entrada do teclado, esse valor de propriedade deverá ser TRUE. |
| UIA_IsOffscreenPropertyId | Depende | Essa propriedade deve retornar um valor para saber se o item de lista está atualmente rolado para exibição dentro do contêiner pai que implementa padrão de controle Scroll. |
| UIA_ItemStatusPropertyId | Depende | Se o controle contiver status que está sendo atualizado dinamicamente, essa propriedade deve ser suportada para que uma tecnologia assistencial possa receber atualizações quando o status do elemento for alterado. |
| UIA_ItemTypePropertyId | Depende | Essa propriedade deve ser exposta para controles de item de lista que representam um objeto subjacente. Esses controles de item de lista normalmente têm um ícone associado ao controle que os usuários associam ao objeto subjacente. |
| UIA_LabeledByPropertyId | Ver notas. | Se houver um rótulo de texto estático, essa propriedade deve expor uma referência a esse controle. |
| UIA_LocalizedControlTypePropertyId | Ver notas. | Cadeia de caracteres localizada correspondente ao ListItem tipo de controle. O valor padrão é "list item" para en-US ou inglês (Estados Unidos). |
| UIA_NamePropertyId | Ver notas. | O valor da propriedade name de um controle de item de lista vem do rótulo de texto do item. |
Padrões de controle necessários
A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados por todos os controles de item de lista. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.
| Padrão de controle | Suporte | Observações |
|---|---|---|
| IExpandCollapseProvider | Depende | Se o item puder ser manipulado para mostrar ou ocultar informações, o padrão de controle ExpandCollapse deverá ser implementado. |
| IGridItemProvider | Depende | Se houver suporte para navegação espacial item a item dentro do contêiner de lista e o contêiner estiver organizado em linhas e colunas, o padrão de controle GridItem deverá ser implementado. |
| IInvokeProvider | Depende | Se o item tiver um comando que possa ser executado nele, separado da seleção, o padrão de controle Invoke deverá ser implementado. Normalmente, essa é uma ação associada a clicar duas vezes no controle de item de lista. Exemplos seriam iniciar um documento a partir do Explorador do Windows ou reproduzir um ficheiro de música no Microsoft Windows Media Player. |
| IScrollItemProvider | Depende | Se o item de lista estiver contido em um contêiner rolável, o padrão de controle ScrollItem deverá ser implementado. |
| ISelectionItemProvider | Depende | Um controle de item de lista que oferece suporte à seleção deve implementar o padrão de controle SelectionItem. Isso permite que os controles de itens de lista transmitam quando são selecionados. |
| IToggleProvider | Depende | Se o item de lista for verificável e a ação não executar uma alteração de estado de seleção, o padrão de controle Toggle deverá ser implementado. |
| IValueProvider | Depende | Se o item puder ser editado, o padrão de controle Valor deverá ser implementado. As alterações no controle de item de lista causarão alterações nos valores das propriedades UIA_NamePropertyId e UIA_ValueValuePropertyId. |
Eventos necessários
A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles de item de lista são necessários para dar suporte. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário .
| Evento de automação da interface do usuário | Observações |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de alteração de propriedade. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento de alteração de propriedade. | Se o controle oferecer suporte ao padrão de controle ExpandCollapse, ele deverá oferecer suporte a esse evento. |
| UIA_Invoke_InvokedEventId | Se o controle oferecer suporte ao padrão de controle Invoke, ele deverá oferecer suporte a esse evento. |
| UIA_IsEnabledPropertyId evento de alteração de propriedade. | Se o controle oferecer suporte à propriedadeIsEnabled, ele deverá oferecer suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento de alteração de propriedade. | Se o controle oferecer suporte à propriedade IsOffscreen, ele deverá oferecer suporte a esse evento. |
| UIA_ItemStatusPropertyId evento de alteração de propriedade. | Se o controle oferecer suporte à propriedade ItemStatus, é necessário oferecer suporte a esse evento. |
| UIA_NamePropertyId evento de alteração de propriedade. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Se o controle oferecer suporte ao padrão de controle SelectionItem, ele deverá oferecer suporte a esse evento. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Se o controle oferecer suporte ao padrão de controle SelectionItem, ele deverá oferecer suporte a esse evento. |
| UIA_SelectionItem_ElementSelectedEventId | Se o controle oferecer suporte ao padrão de controle SelectionItem, ele deverá oferecer suporte a esse evento. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId evento de alteração de propriedade. | Se o controle oferecer suporte ao padrão de controle Toggle, ele deverá oferecer suporte a esse evento. |
| UIA_ValueValuePropertyId evento de alteração de propriedade. | Se o controle oferecer suporte ao padrão de controle valor, ele deverá oferecer suporte a esse evento. |
Comentários
Se um contêiner hospedar itens de lista, o principal meio de navegação deve ir para os itens de lista. Colocar o foco em subelementos através da navegação na lista pode ser confuso para os usuários e ferramentas de acessibilidade. Se o contêiner hospedar uma lista vertical de itens, pressionar as teclas SETA PARA CIMA e SETA PARA BAIXO deve navegar pelos itens, mas pressionar as teclas SETA PARA A DIREITA e SETA PARA A ESQUERDA pode navegar até subelementos do item focado, como colunas de lista ou subelementos da interface do usuário.
Tópicos relacionados
-
Conceptual
-
Visão geral dos tipos de controle de automação da interface do UI