Suporte de Automação de Interface de Usuário para o Tipo de Controle Item de Lista
Este tópico fornece informações sobre Suporte para o ListItem() Tipo de controle.Em Um tipo de controle é um conjunto de condições que um controle deve atender em Ordem para usar o ControlTypeProperty Propriedade.As condições incluem guia específico linhas para estrutura de árvore, valores de propriedade e Padrões de Controlarar.
Controles de item de lista são um exemplo de controles que implementam um tipo de controle de Item de Lista.
As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de Controlarar e eventos para o tipo de Controlarar ListItem.O Requisitos Aplicar para todos Lista controles, se , Win32, ou .
Este tópico contém as seguintes seções.
- Estrutura de Árvore de Automação de IU Requerida
- Propriedades de Automação de IU Requeridas
- Padrões de Controle de Automação de IU Requeridos
- Eventos de Automação de IU Requeridos
- Tópicos relacionados
Estrutura de Árvore de Automação de IU Requerida
A tabela a seguir descreve o Modo de controle e o exibição de conteúdo do Árvore que pertence ao item da lista Controles e descreve o que pode estar contido em cada Exibir.Para obter mais informações sobre o árvore, consulte Visão geral da árvore de automação de interface do usuário.
Visão de Controle |
Visão de Conteúdo |
|---|---|
|
|
Os filhos de um controle de item no modo de exibição de conteúdo da lista de Árvore sempre deve ser "0".Se a estrutura do controle for de forma que outros itens estão sob o item da lista, ele deve seguir os requisitos para o Suporte de Automação de Interface de Usuário para o Tipo de Controle TreeItem Controle tipo.
Propriedades de Automação de IU Requeridas
O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de item de lista.Para obter mais informações propriedades, consulte UI Automation Properties for Clients.
Propriedade |
Value (Valor) |
Anotações |
|---|---|---|
AutomationIdProperty() |
Veja anotações. |
O valor desta propriedade precisa ser único em todos os controles de uma aplicação. |
Veja anotações. |
O valor desta propriedade deve incluir a área dos conteúdos de imagem e texto do item de lista. |
|
Depende |
Se o controle de lista possui um ponto clicável (um ponto que pode ser clicado para causar o recebimento do foco pela lista) então este ponto precisa ser exposto através desta propriedade.Se o controle de lista é completamente coberto por itens de lista descendentes ele aumentará uma NoClickablePointException Para indicar que o cliente deve solicitar um item dentro de controle de lista para um ponto que pode ser clicado. |
|
Veja anotações. |
O valor da propriedade nome de um controle de item de lista vem do conteúdo texto do item. |
|
Veja anotações. |
Se houver um rótulo texto estático então esta propriedade precisa expor uma referência para aquele controle. |
|
ListItem |
Esse valor é o mesmo para todos os frameworks de IU. |
|
"item de lista" |
String localizada correspondente ao tipo de controle Item de Lista. |
|
True |
O controle de lista é sempre incluídos na exibição de conteúdo das árvore. |
|
True |
O controle de lista é sempre incluídos na exibição de controle das árvore. |
|
True |
Se o contêiner pode aceitar entrada via teclado então este valor de propriedade deve ser verdadeiro. |
|
"" |
O texto de ajuda para controles de lista deve explicar porquê o usuário está sendo requisitado a realizar uma escolha dentre as opções da lista.Por exemplo, "Selecionando um item desta lista irá escolher a resolução do seu monitor." |
|
Depende |
Esta propriedade deve ser exposta para controles de item de lista que estão representando um objeto subjacente.Estes controles de item de lista tipicamente possuem um ícone associado ao controle que o usuário associa ao objeto subjacente. |
|
Depende |
Esta propriedade precisa retornar um valor para caso o item de lista esteja rolado atualmente dentro da visão de um contêiner pai que implementa o padrão de controle Scroll. |
Padrões de Controle de Automação de IU Requeridos
O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por controles de item de lista.Para obter mais informações sobre padrões de controle, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.
Padrão de Controle/Propriedade de Padrão de Controle |
Suporte/Valor |
Anotações |
|---|---|---|
Sim |
Controle de item de lista precisa implementar teste padrão de controle.Isto permite controles de item de lista informarem quando são selecionados. |
|
Depende |
Se o item de lista estiver contido em um contêiner rolável então o padrão de controle precisa ser implementado. |
|
Depende |
Se o item de lista for checável e a ação não faz uma mudança no estado de seleção então este padrão de controle precisa ser implementado. |
|
IExpandCollapseProvedor |
Depende |
Se o item pode ser manipulado para exibir ou esconder informação então este padrão de controle precisa ser implementado. |
Depende |
Se o item puder ser editado então este padrão de controle precisa ser implementado.Alterações para o controle de item da lista fará com que os valores das alterações NamePropertye Value. |
|
IGridItemProvedor |
Depende |
Se navegação espacial item-a-item for suportada dentro do contêiner de lista e o contêiner estiver disposto em linhas e colunas então o padrão de controle Item de Grade precisa ser implementado. |
IInvokeProvedor |
Depende |
Se o item possui um comando que pode ser executado em si, diferente da seleção, então este padrão precisa ser implementado.Isto tipicamente é uma ação associada ao clique-duplo do controle de item de lista.Exemplos poderiam ser iniciando um documento a partir ou reproduzir um arquivo de música no . |
Eventos de Automação de IU Requeridos
O seguinte tabela Listas o Eventos necessárias para ser suportadas por Tudo controles de lista de item.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.
Evento |
Suporte |
Anotações |
|---|---|---|
Depende |
Nenhum |
|
Necessário |
Nenhum |
|
Necessário |
Nenhum |
|
Necessário |
Nenhum |
|
BoundingRectangleProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
IsOffscreenProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
IsEnabledProperty Evento de propriedade alterado. |
Necessário |
Nenhum |
Necessário |
Nenhum |
|
ItemStatusProperty Evento de propriedade alterado. |
Depende |
Nenhum |
ExpandCollapseStateProperty Evento de propriedade alterado. |
Depende |
Nenhum |
ValueProperty Evento de propriedade alterado. |
Depende |
Nenhum |
ToggleStateProperty Evento de propriedade alterado. |
Depende |
Nenhum |
Necessário |
Nenhum |
|
Necessário |
Nenhum |
Consulte também
Conceitos
Visão Geral dos Tipos de Controle de Automação de Interface do Usuário
Referência
ListItem()