Suporte à Automação UI para o Tipo de Controle SplitButton

Este tópico fornece informações sobre Suporte para o SplitButton 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 controle de botão de divisão permite executar uma ação em um controle e expandir o controle para ver uma lista de outras ações possíveis que podem ser executadas.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de Controlarar e eventos para o tipo de Controlarar SplitButton.O Requisitos Aplicar para todos dividir controles de botão, 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
• Exemplo do Controle SplitButton
• 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 dividir botão Controles e descreve o que pode estar contido em cada modo de exibição.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
SplitButton Imagem (0 ou 1) Texto (0 ou 1) Botão (1 ou 2) Menu MenuItem (1 para muitos)	SplitButton MenuItem (1 para muitas)

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para controles de botão Dividir.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.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
NameProperty	"Back"	O nome do controle de botão split é exibido no botão.
LabeledByProperty	Null	Controles de botão split não têm um rótulo de texto estático.
ControlTypeProperty	SplitButton	Esse valor é o mesmo para todos os frameworks de IU.
LocalizedControlTypeProperty	"botão de split"	String localizada correspondente ao tipo de controle SplitButton.
HelpTextProperty	"Símbolo Seta à Esquerda"	A descrição visual para a imagem contida no botão.
IsContentElementProperty	True	O controle de botão split contém informações para o usuário final.
IsControlElementProperty	True	O controle de botão split é visível para o usuário final.

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

O seguinte tabela Listas o Controlar padrões necessárias para ser suportadas por Dividir botão controles.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
IInvokeProvedor	Necessário	Botões Split sempre têm uma ação padrão associada ao Invoke.
IExpandCollapseProvedor	Necessário	Botões Split sempre têm a capacidade para expandir uma lista de opções.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de botão de divisã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
InvokedEvent	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
ExpandCollapseStateProperty Evento de propriedade alterado.	Necessário	Nenhum
AutomationFocusChangedEvent	Necessário	Nenhum
StructureChangedEvent	Necessário	Nenhum

Exemplo do Controle SplitButton

A imagem a seguir ilustra um controle que implementa o tipo de controle Data Grid.

Exibir de controle - árvore	Árvore - exibir conteúdo
DataGrid (Sort, Table, Selection, Grid) Header HeaderItem "Nome" (Invoke) SplitButton (Chamar)	Data Grid (Sort, Table, Selection, Grid) Header HeaderItem (Chamar)

Consulte também

Conceitos

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

UI Automation Overview

Referência

SplitButton()