Tipo de controle de imagem
Este tópico fornece informações sobre o suporte do Microsoft Automação da Interface do Usuário para o tipo de controle Imagem.
Os controles de imagem usados como ícones, gráficos informativos e gráficos darão suporte ao tipo de controle Imagem . Os controles usados como imagens de tela de fundo ou marca d'água não darão suporte ao tipo de controle Imagem .
As seções a seguir definem o Automação da Interface do Usuário estrutura de árvore, propriedades, padrões de controle e eventos necessários para o tipo de controle Image. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de imagem em que a estrutura/plataforma da interface do usuário integra Automação da Interface do Usuário suporte para tipos de controle e padrões de controle.
Este tópico inclui as seções a seguir.
- Estrutura de árvore típica
- Propriedades relevantes
- Padrões de controle necessários
- Eventos obrigatórios
- Tópicos relacionados
Estrutura de árvore típica
A tabela a seguir ilustra um controle típico e uma exibição de conteúdo da árvore Automação da Interface do Usuário que pertence aos controles de imagem e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de Automação da Interface do Usuário, consulte Visão geral da árvore de Automação da Interface do Usuário.
| Exibição de controle | Exibição de conteúdo |
|---|---|
| Image | Image (Depende se a imagem contém informações, com base no valor da propriedade Automation Element Property Identifiers ) |
Propriedades relevantes
A tabela a seguir lista as propriedades Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles de imagem. Para obter mais informações sobre Automação da Interface do Usuário propriedades, consulte Recuperando propriedades de elementos Automação da Interface do Usuário.
| Propriedade de Automação da Interface do Usuário | Valor | Observações |
|---|---|---|
| UIA_AutomationIdPropertyId | Veja as observações. | O valor dessa propriedade deve ser exclusivo entre todos os elementos pares na exibição bruta da árvore Automação da Interface do Usuário. |
| UIA_BoundingRectanglePropertyId | Veja as observações. | O retângulo mais externo que contém todo o controle. |
| UIA_ClickablePointPropertyId | Veja as observações. | O ponto clicável do controle de imagem deve ser um ponto dentro do retângulo delimitador do controle de imagem. |
| UIA_ControlTypePropertyId | Imagem | |
| UIA_HelpTextPropertyId | Veja as observações. | A propriedade HelpText expõe uma cadeia de caracteres localizada que descreve a aparência visual real do controle ou outras informações de dica de ferramenta associadas à imagem. Essa propriedade deve ter suporte quando uma descrição longa é necessária para transmitir mais informações sobre o controle de imagem (por exemplo, se a imagem for um gráfico ou diagrama complicado). Essa propriedade é mapeada para a marca HTML LongDesc e a marca SVG (Scalable Vector Graphics) Desc . Os desenvolvedores que trabalham com controles de imagem devem dar suporte a uma propriedade para permitir que a descrição visual seja definida no controle. Essa propriedade deve ser mapeada para o Automação da Interface do Usuário propriedade VisualDescription. |
| UIA_IsContentElementPropertyId | Veja as observações. | O controle de imagem deve ser incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário quando ele contém informações significativas ainda não expostas ao usuário final. |
| UIA_IsControlElementPropertyId | TRUE | O controle de imagem é sempre incluído na exibição de controle da árvore de Automação da Interface do Usuário. |
| UIA_IsKeyboardFocusablePropertyId | Veja as observações. | Se o controle puder receber o foco do teclado, ele deverá dar suporte a essa propriedade. |
| UIA_ItemStatusPropertyId | Veja as observações. | Se o controle de imagem representar informações de estado sobre um item específico na tela, o controle deverá estar contido no item. Quando a imagem está contida em um item, o item deve dar suporte à propriedade status e gerar notificações apropriadas quando o status for alterado. Se uma imagem for um controle autônomo e estiver transmitindo o status, essa propriedade deverá ter suporte. |
| UIA_LabeledByPropertyId | Veja as observações. | Se houver um rótulo de texto estático, essa propriedade deverá expor uma referência a esse controle. |
| UIA_LocalizedControlTypePropertyId | Veja as observações. | Cadeia de caracteres localizada correspondente ao tipo de controle Imagem . O valor padrão é "image" para en-US ou inglês (Estados Unidos). |
| UIA_NamePropertyId | Veja as observações. | A propriedade Name deve ser exposta para todos os controles de imagem que contêm informações. O acesso programático a essas informações requer que um equivalente textual ao gráfico seja fornecido. Se o controle de imagem for puramente decorativo, ele só deverá aparecer na exibição de controle da árvore Automação da Interface do Usuário e não será necessário ter um nome (consulte Comentários). As estruturas de interface do usuário devem dar suporte a uma propriedade de texto ALT ou alternativa em imagens que podem ser definidas dentro de sua estrutura. Essa propriedade será mapeada para a propriedade Nome da Automação da Interface do Usuário. |
Padrões de controle necessários
A tabela a seguir lista os padrões de controle de Automação da Interface do Usuário necessários para ter suporte para controles de imagem. Para obter mais informações sobre padrões de controle, consulte Visão geral dos padrões de controle da Automação da Interface do Usuário.
| Padrão de controle | Suporte | Observações |
|---|---|---|
| IGridItemProvider | Depende | O controle de imagem dá suporte ao padrão de controle GridItem se o controle estiver dentro de um contêiner de grade. |
| IInvokeProvider | Nunca | Se o controle de imagem for um objeto clicável, o controle deverá dar suporte a um tipo de controle que dê suporte ao padrão de controle Invoke , como o tipo de controle Button . Para um objeto de imagem que contém vários objetos clicáveis, o elemento (tipo de controle Image) pode hospedar links filho (tipo de controle Hyperlink) na árvore Automação da Interface do Usuário. |
| ISelectionItemProvider | Nunca | Os controles de imagem não devem dar suporte ao padrão de controle SelectionItem . Se as imagens fizerem parte de um contêiner que é selecionável, como um botão que tem um ícone de imagem como conteúdo, esse contêiner dá suporte ao padrão, não à imagem dentro. |
| ITableItemProvider | Depende | O controle de imagem dá suporte ao padrão de controle TableItem se o controle estiver dentro de um contêiner que tenha controles de cabeçalho. |
Eventos obrigatórios
A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles de imagem são necessários para dar suporte. Para mais informações sobre eventos, confira Visão geral de eventos de Automação da Interface do Usuário.
| Evento de Automação da Interface do Usuário | Observações |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de alteração de propriedade. | |
| UIA_IsEnabledPropertyId evento de alteração de propriedade. | Se o controle der suporte à propriedade IsEnabled , ele deverá dar suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento de alteração de propriedade. | Se o controle der suporte à propriedade IsOffscreen , ele deverá dar suporte a esse evento. |
| UIA_ItemStatusPropertyId evento de alteração de propriedade. | Se o controle der suporte à propriedade ItemStatus , ele deverá dar suporte a esse evento. |
| UIA_NamePropertyId evento de alteração de propriedade. | |
| UIA_StructureChangedEventId |
Comentários
O W3C (World Wide Web Consortium) define uma imagem decorativa como aquela que não adiciona informações ao conteúdo de uma página. Para obter mais detalhes, consulte o tópico W3C sobre imagens decorativas.
Com relação a Automação da Interface do Usuário:
- Se uma imagem for puramente decorativa, não for interativa e não transmitir nenhuma informação, a imagem:
- Pode ou não estar na árvore UIA
- Pode ou não estar na exibição bruta do UIA
- Não deve estar na exibição de controle UIA
- Não deve estar na exibição de conteúdo
- Pode ou não ter um nome
- Se uma imagem transmitir informações, mas houver um texto claramente associado que forneça as mesmas informações (como um botão reproduzir que contém um gráfico de triângulo apontando para a esquerda junto com o texto "reproduzir"), a imagem será considerada decorativa e a imagem:
- Deve estar na exibição bruta
- Deve estar na exibição de controle
- Não deve estar na exibição de conteúdo
- Pode ou não ter um valor na propriedade Name
- O texto que também transmite o significado da imagem deve estar na exibição de conteúdo
- Se uma imagem for informativa e transmitir detalhes que não são fornecidos por nenhum texto associado, a imagem:
- Deve estar na exibição bruta
- Deve estar na exibição de controle
- Deve estar na exibição de conteúdo
- Deve ter um valor de nome que descreva a imagem e seu significado