Partilhar via


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

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
  • ListItem
    • Imagem (0 ou mais)
    • Texto (0 ou mais)
    • Editar (0 ou mais)
  • ListItem

 

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.

Conceptual

Visão geral dos tipos de controle de automação da interface do UI

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