Tipo de controle ListItem
Este tópico fornece informações sobre o suporte do Microsoft Automação da Interface do Usuário 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 o Automação da Interface do Usuário estrutura de árvore, 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 Automação da Interface do Usuário suporte para tipos de controle e padrões de controle.
Este tópico inclui as seções a seguir.
- Estrutura de árvore típica
- Propriedades relevantes
- Padrões de controle necessários
- Eventos obrigatórios
- Comentários
- Tópicos relacionados
Estrutura de árvore típica
A tabela a seguir ilustra um controle típico e uma exibição de conteúdo da árvore Automação da Interface do Usuário que pertence a 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.
| Exibição de controle | Exibição de conteúdo |
|---|---|
|
|
Os filhos de um controle de item de lista na exibição de conteúdo da árvore Automação da Interface do Usuário sempre devem mostrar zero filhos. Se a estrutura do controle for tal que outros itens estão contidos abaixo do item de lista, ele deverá seguir os requisitos para o suporte Automação da Interface do Usuário para o tipo de controle TreeItem.
Propriedades relevantes
A tabela a seguir lista as propriedades 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 Automação da Interface do Usuário propriedades, consulte Recuperando propriedades de elementos Automação da Interface do Usuário.
| Propriedade de Automação da Interface do Usuário | Valor | Observações |
|---|---|---|
| UIA_AutomationIdPropertyId | Veja as observações. | O valor dessa propriedade deve ser exclusivo entre todos os elementos pares na exibição bruta da árvore 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 | Veja as observações. | Esse valor dessa propriedade deve incluir a área do conteúdo de imagem e 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 se concentre), esse ponto deverá ser exposto por meio dessa propriedade. Se o controle de lista for completamente coberto por itens de lista descendentes, ele retornará o erro 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 da IU. |
| UIA_HelpTextPropertyId | Veja as observações. | 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 | TRUE | O controle de lista sempre está incluído na exibição de conteúdo da árvore da Automação da Interface do Usuário. |
| UIA_IsControlElementPropertyId | TRUE | O controle de lista sempre está incluído na exibição de controle da árvore da Automação da Interface do Usuário. |
| UIA_IsKeyboardFocusablePropertyId | Veja as observações. | 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 atualmente é rolado para exibição dentro do contêiner pai que implementa o padrão de controle Scroll . |
| UIA_ItemStatusPropertyId | Depende | Se o controle contiver status que está sendo atualizado dinamicamente, essa propriedade deverá ter suporte para que uma tecnologia adaptativa 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 | Veja as observações. | Se houver um rótulo de texto estático, essa propriedade precisará expor uma referência a esse controle. |
| UIA_LocalizedControlTypePropertyId | Veja as observações. | Cadeia de caracteres localizada correspondente ao tipo de controle ListItem . O valor padrão é "item de lista" para en-US ou inglês (Estados Unidos). |
| UIA_NamePropertyId | Veja as observações. | 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 dos padrões de controle da 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 no contêiner de lista e o contêiner for organizado em linhas e colunas, o padrão de controle GridItem deverá ser implementado. |
| IInvokeProvider | Depende | Se o item tiver um comando que pode ser executado nele, separado da seleção, o padrão de controle Invoke deverá ser implementado. Normalmente, essa é uma ação associada ao clique duplo no controle de item de lista. Exemplos seriam iniciar um documento do Windows Explorer ou reproduzir um arquivo de música no Microsoft Reprodutor Multimídia do Windows. |
| IScrollItemProvider | Depende | Se o item de lista estiver contido em um contêiner que seja rolável, o padrão de controle ScrollItem deverá ser implementado. |
| ISelectionItemProvider | Depende | Um controle de item de lista que dá 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 Alternância 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 obrigatórios
A tabela a seguir lista os eventos Automação da Interface do Usuário que listam controles de item são necessários para dar suporte. Para mais informações sobre eventos, confira 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 com alteração de propriedade. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento com alteração de propriedade. | Se o controle der suporte ao padrão de controle ExpandCollapse , ele deverá dar suporte a esse evento. |
| UIA_Invoke_InvokedEventId | Se o controle der suporte ao padrão de controle Invoke , ele deverá dar suporte a esse evento. |
| UIA_IsEnabledPropertyId evento com alteração de propriedade. | Se o controle der suporte à propriedade IsEnabled , ele deverá dar suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento com alteração de propriedade. | Se o controle der suporte à propriedade IsOffscreen , ele deverá dar suporte a esse evento. |
| UIA_ItemStatusPropertyId evento com alteração de propriedade. | Se o controle der suporte à propriedade ItemStatus , deverá dar suporte a esse evento. |
| UIA_NamePropertyId evento com alteração de propriedade. | |
| UIA_SelectionItem_ElementAddedToSelectionEventId | Se o controle der suporte ao padrão de controle SelectionItem , ele deverá dar suporte a esse evento. |
| UIA_SelectionItem_ElementRemovedFromSelectionEventId | Se o controle der suporte ao padrão de controle SelectionItem , ele deverá dar suporte a esse evento. |
| UIA_SelectionItem_ElementSelectedEventId | Se o controle der suporte ao padrão de controle SelectionItem , ele deverá dar suporte a esse evento. |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId evento com alteração de propriedade. | Se o controle der suporte ao padrão de controle Desativar , ele deverá dar suporte a esse evento. |
| UIA_ValueValuePropertyId evento com alteração de propriedade. | Se o controle der suporte ao padrão de controle Value , ele deverá dar suporte a esse evento. |
Comentários
Se um contêiner hospedar itens de lista, os principais meios de navegação deverão ir para os itens da lista. Colocar o foco em subelementos por meio da navegação de lista pode ser confuso para 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 deverá navegar pelos itens, mas pressionar as teclas SETA PARA A DIREITA e SETA PARA A ESQUERDA poderá navegar até subelementos do item focado, como colunas de lista ou subelementos de interface do usuário.
Tópicos relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de