Suporte à Automação de IU para o tipo de controle Image

Este tópico fornece informações sobre Suporte para a imagem 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 Image usados como ícones, elementos gráficos informativos e gráficos oferecerão suporte ao tipo de controle Image.Imagens de plano de fundo e de marca d'água não oferecem suporte ao tipo de controle Image.

As seções a seguir Definirm a necessária estrutura de árvore, propriedades, padrões de controle e eventos para o tipo de controle de imagem.O Requisitos Aplicar para todos imagem 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 diz respeito a controles de imagem 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
Image	Depende se a imagem contém informações (com base no valor de IsContentElement Propriedade)

Propriedades de Automação de IU Requeridas

O seguinte tabela Listas o As propriedades cujo valor ou definição é especialmente relevantes para a imagem controlam tipo.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.	O ponto clicável do controle de imagem deve ser um ponto dentro do retângulo delimitador do controle de imagem.
IsKeyboardFocusableProperty	Veja anotações.	Se o controle pode receber o foco do teclado, deve suportar essa propriedade.
NameProperty	Veja anotações.	A propriedade Name deve ser exposta para todos os controles de imagem que contêm informações.O acesso via programação a essas informações requer que um equivalente textual para o gráfico seja fornecido.Se o controle de imagem for puramente decorativo, ele deve apenas aparecem na exibição do controle de árvore e não é necessário para ter um nome.Os frameworks de interface do usuário devem suportar uma propriedade ALT ou um texto alternativo em imagens que podem ser definidas de dentro do framework.Essa propriedade será, em seguida, mapear para a Nome de propriedade.
LabeledByProperty	Veja anotações.	Se houver um rótulo texto estático então esta propriedade precisa expor uma referência para aquele controle.
ControlTypeProperty	Image	Esse valor é o mesmo para todos os frameworks de IU.
LocalizedControlTypeProperty	"image"	String localizada correspondente ao tipo de controle Image.
IsContentElementProperty	Veja anotações.	O controle de imagem deve ser incluído na exibição de conteúdo das Árvore quando ele contém informações significativas não AL Pronto expostos ao usuário final.
IsControlElementProperty	True	O controle de imagem é sempre incluído na exibição de controle das árvore.
HelpTextProperty	Veja anotações.	O HelpText Propriedade expõe um localizadas Cadeia de Caracteres que descreve a aparência visual real do controle (por exemplo, quadrado vermelho com um em branco ‘ X ’). Essa propriedade deve ser suportada quando uma descrição longa é necessária para transmitir mais informações sobre o controle de imagem.Por exemplo, um gráfico complicado ou um diagrama.Essa propriedade Mapas para a LongDesc marca e o Marca desc.Os desenvolvedores trabalhando com controles de imagem devem prover suporte a uma propriedade para permitir que uma descrição visual seja definida no controle.Esta propriedade deve ser mapeada para o Propriedade VisualDescription. Isso é geralmente necessário quando a imagem é usada como um controle de conteúdo.
ItemStatusProperty	Veja anotações.	Se o controle de imagem representa informações de estado sobre um item específico na tela, o controle deve estar contido dentro do item.Quando a imagem está contida em um item, o item deve oferecet suporte à propriedade de status e lançar as notificações apropriadas quando o status é alterado. Se uma imagem é um controle autônomo e transmite status, esta propriedade deve ser suportada.

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 de imagem.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
IGridItemProvedor	Depende	O controle de imagem oferece suporte ao padrão Grid Item se o controle estiver em um contêiner de grade.
ITableItemProvider	Depende	O controle de imagem oferece suporte ao padrão Table Item se o controle estiver em um contêiner que tem controles de cabeçalho.
IInvokeProvedor	Nunca	Se o controle de imagem contém uma imagem que pode ser clicada, o controle deve dar suporte a um tipo de controle que ofereça suporte ao padrão Invoke, como o tipo de controle Button.
ISelectionItemProvider	Nunca	Controles de imagem não devem dar suporte ao padrão Selection Item.

Eventos de Automação de IU Requeridos

O seguinte tabela Listas o Eventos necessárias para ser suportadas por todos os controles de imagem.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	Nunca	Nenhum
ElementAddedToSelectionEvent	Nunca	Nenhum
ElementRemovedFromSelectionEvent	Nunca	Nenhum
ElementSelectedEvent	Nunca	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
NameProperty Evento de propriedade alterado.	Necessário	Nenhum
AutomationFocusChangedEvent	Necessário	Nenhum
StructureChangedEvent	Necessário	Nenhum

Consulte também

Conceitos

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

UI Automation Overview

Referência

Image()