Suporte de automação de interface do usuário para o tipo de controle List
Este tópico fornece informações sobre Suporte para a lista 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.
O tipo de controle List fornece uma maneira de organizar um grupo ou grupos de itens e permite que um usuário selecione um ou mais desses itens.O tipo de controle List tem uma restrição folgada sobre que tipos de elementos filho ele pode conter.Isso permite Provedores de automação interface do usuário Para oferecer suporte um elemento conhecido para Contêineres de seleção.
O requisitos em seções a seguir Aplicar para todos os controles que implementam a lista Controle Tipo, se , Win32, ou .Controles contêiner de lista são um exemplo de controles que implementam o tipo de controle List.
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 os dois Exibições das Árvore referentes à lista Controles e descreve o que pode estar contido em cada Exibir.O Modo de controle Contém apenas elementos que são controles, e o exibição de conteúdo Remove informações redundantes de a árvore.Por exemplo, um controle de texto usado para Rótulo um caixa de combinação será exposto como o Caixa de Combinação NameProperty.Como o controle de texto já está exposto dessa maneira por meio do modo de exibição de controle, é desnecessário expô-lo duas vezes; portanto, ele será removido do modo de exibição de conteúdo.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 |
|---|---|
Contém os elementos que correspondem aos controles. |
Remove as informações redundantes da árvore para que tecnologias de auxílio funcionem com o menor conjunto de informações significativas para o usuário final. |
|
|
O modo de exibição de controle para um controle que implementa o tipo de controle List (como um controle de lista) consiste de:
Zero ou mais itens dentro do controle de lista (itens podem ser baseados nos tipos de controle ListItem ou DataItem)
Zero ou mais controles de grupo em um controle de lista
Zero, um ou dois controles de barra de rolagem
O modo de exibição de conteúdo de um controle que implementa o tipo de controle List (como um controle de lista) consiste de:
Zero ou mais itens dentro do controle de lista (itens podem ser baseados nos tipos de controle ListItem ou DataItem)
Zero ou mais grupos dentro do controle de lista
Um controle de lista não deve ter itens que têm uma relação hierárquica diferente de estar sendo agrupados juntos.Se os itens filhos têm o Árvore, em seguida, o Contêiner Lista deve se basear no tipo de controle de árvore.
O Selec Tabela itens dentro de controle de lista estará disponíveis a partir de descendentes na árvore da controle de lista.Todos os itens dentro de controle de lista devem pertencer ao mesmo grupo de seleção.
Propriedades de Automação de IU Requeridas
O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles 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 retângulo mais externo que contém o controle inteiro. |
|
Veja anotações. |
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 valor da IsOffScreen Propriedade É verdadeiro, em seguida, o NoClickablePointExceptionserá gerado. |
|
Veja anotações. |
Se o controle pode receber o foco do teclado, deve suportar essa propriedade. |
|
Veja anotações. |
O valor da propriedade Name de um controle de lista deve transmitir a categoria de opções a partir da qual o usuário está sendo solicitado a selecionar elementos.Esta propriedade normalmente obtém seu nome de um rótulo de texto estático.Se não houver um rótulo de texto estático, o desenvolvedor do aplicativo deve expor um valor para a propriedade Name. A única situação em que essa propriedade não é necessária para controles de lista é se o controle é usado dentro da subárvore de um outro controle. |
|
Veja anotações. |
Se houver um rótulo texto estático então esta propriedade precisa expor uma referência para aquele controle. |
|
List |
Esse valor é o mesmo para todos os frameworks de IU. |
|
"list" |
String localizada correspondente ao tipo de controle List. |
|
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. |
|
Veja anotações. |
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á definir a resolução do seu monitor." |
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 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 |
|---|---|---|
ISelectionProvedor |
Necessário |
Todos os controles que suportam o tipo de controle de lista devem implementar ISelectionProvider Quando uma seleção estado é mantido entre os itens contidos no controle.Se os itens no recipiente são não selecionável, o tipo de controle Group deve ser usado. |
IsSelectionRequired() |
Depende |
Controles de lista nem sempre necessitam que um item seja selecionado. |
Depende |
Controles List podem ser contêiners de seleção única ou múltipla. |
|
Depende |
Implemente esse padrão de controle se os itens no contêiner são roláveis. |
|
Depende |
Implemente esse padrão quando navegação de grade precisa estar disponível item por item. |
|
Depende |
Implemente esse padrão de controle se o controle pode suportar vários modos de exibição dos itens no contêiner. |
|
Nunca |
ITableProvider é Nunca suporte para o tipo de controle de lista.Se o controle deve suportar esse padrão de controle, então o controle deve ser baseado no tipo de controle de grade de dados. |
Eventos de Automação de IU Requeridos
O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de lista.Para obter mais informações sobre eventos, consulte Visão geral sobre eventos de automação de interface do usuário.
Evento |
Suporte/Valor |
Anotações |
|---|---|---|
Depende |
Nenhum |
|
Depende |
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 |
CurrentViewProperty Evento de propriedade alterado. |
Depende |
Nenhum |
HorizontallyScrollableProperty Evento de propriedade alterado. |
Depende |
Nenhum |
HorizontalScrollPercentProperty Evento de propriedade alterado. |
Depende |
Nenhum |
HorizontalViewSizeProperty Evento de propriedade alterado. |
Depende |
Nenhum |
VerticalScrollPercentProperty Evento de propriedade alterado. |
Depende |
Nenhum |
VerticallyScrollableProperty Evento de propriedade alterado. |
Depende |
Nenhum |
VerticalViewSizeProperty 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
List()