Partilhar via


Suporte de Automação de Interface de Usuário para o Tipo de Controle da Caixa Combo

Este tópico fornece informações sobre Suporte para a caixa de combinação 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 Padrões de Controlarare Os eventos.

Uma caixa combo é uma caixa de lista combinada com um controle estático ou um controle de edição que mostra o item atualmente selecionado na porção da caixa de lista da caixa combo.A porção da caixa de lista do controle é mostrada o tempo todo ou somente aparece quando o usuário seleciona a seta de expansão (que é um botão de pressionar) próximo ao controle.Se o campo de seleção é um controle de edição, o usuário pode inserir informação que não está na lista; caso contrário, o usuário só pode selecionar itens da lista.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle Caixa de Combinação.O Requisitos Aplicar para todos os controles caixa de combinação, se , Win32, ou .

Este tópico contém as seguintes seções.

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 caixa de combinação controla 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

  • ComboBox

    • Editar(0 ou 1)

    • Listar(1)

    • List Item (filho da lista; 0 Para muitos)

    • Botão (1)

  • ComboBox

    • Item Listado (de 0 a muitos)

O controle de edição na visualização de controle da caixa combo é necessário somente se a caixa combo pode ser editada para receber qualquer entrada, como no caso da caixa combo na caixa de diálogo Executar.

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles caixa de combinação.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.

BoundingRectangleProperty

Veja anotações.

O retângulo mais externo que contém o controle inteiro.

ClickablePointProperty

Veja anotações.

Suportado se houver um retângulo de fronteiras.Se nem todo ponto dentro do retângulo de fronteira é clicável, e você realiza teste de hit especializado, então sobreponha e forneça um ponto clicável.

ControlTypeProperty

ComboBox

Esse valor é o mesmo para todos As estruturas.

HelpTextProperty

Veja anotações.

O texto de ajuda para controles de caixa combo deve explicar porquê o usuário está sendo requisitado a realizar uma escolha dentre as opções da caixa combo.Por exemplo, "Selecionando um item desta caixa combo irá escolher a resolução do seu monitor."

IsContentElementProperty

True

Controles de Caixa de combinação sempre são incluídos na exibição do conteúdo de árvore.

IsControlElementProperty

True

Controles de Caixa de combinação sempre são incluídos na exibição do controle de árvore.

IsKeyboardFocusableProperty

True

Controles de caixa combo expõem um conjunto de itens de um contêiner de seleções.O caixa de combinação controle pode receber o foco do teclado, embora quando um Cliente de Automação interface do usuário Conjuntos focalizar um caixa de combinação, qualquer itens in a caixa de combinação subárvore pode receber o foco.

LabeledByProperty

Veja anotações.

Controles de caixa combo tipicamente tem uma etiqueta de texto estática a qual esta propriedade se refere.

LocalizedControlTypeProperty

"caixa combo"

String localizada correspondente ao tipo de controle de CaixaCombo.

NameProperty

Veja anotações.

O controle de caixa combo tipicamente recebe seu nome de um controle de texto estático.

Padrões de Controle de Automação de IU Requeridos

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por todos os controles caixa de combinação.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

IExpandCollapseProvedor

Sim

O controle de caixa combo deve sempre conter um botão de expansão para que seja uma caixa combo.

ISelectionProvedor

Sim

Mostra a seleção atual da caixa combo.Este suporte é delegado a caixa de lista da caixa combo.

IValueProvider

Depende

Se a caixa combo tem a habilidade de receber valores texto arbitrários, o padrão Valor deve ser suportado.Este padrão fornece a habilidade de programaticamente setar o conteúdo de strings da caixa combo.Se o padrão Valor não é suportado, isto indica que o usuário deve selecionar da lista de itens dentro da sub-árvore da caixa combo.

IScrollProvider

Nunca

O padrão Rolagem nunca é suportado em uma caixa combo diretamente.É suportado se uma caixa de lista contida na caixa combo pode rolar.Só pode ser suportado quando a caixa lista é visível na tela.

Eventos Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles caixa de combinação.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

AutomationFocusChangedEvent

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

StructureChangedEvent

Necessário

Nenhum

ExpandCollapseStateProperty Evento de propriedade alterado.

Necessário

Nenhum

ValueProperty Evento de propriedade alterado.

Depende

Se o controle suporta o padrão Valor, deve suportar este evento.

Consulte também

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview

Referência

ComboBox