Partilhar via


Tipo de controle de imagem

Este tópico fornece informações sobre o suporte da Automação da Interface do Usuário da Microsoft 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 plano de fundo ou marca d'água não suportarão o tipo de controle Image.

As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle Imagem. 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 o suporte à automação da interface do usuário para tipos de controle e padrões de controle.

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

Estrutura típica da árvore

A tabela a seguir descreve uma exibição típica de controle e conteúdo da árvore de 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 .

Vista de controlo Visualização de conteúdo
Imagem Imagem (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 de 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 as propriedades de automação da interface do usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.

Propriedade de automação da interface do usuário Valor Observações
UIA_AutomationIdPropertyId Ver notas. O valor dessa propriedade deve ser exclusivo entre todos os elementos de mesmo nível na exibição bruta da árvore de Automação da Interface do Usuário.
UIA_BoundingRectanglePropertyId Ver notas. O retângulo mais externo que contém todo o controle.
UIA_ClickablePointPropertyId Ver notas. 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 Ver notas. 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 ser suportada quando uma descrição longa é necessária para transmitir mais informações sobre o controle de imagem (por exemplo, se a imagem é um gráfico ou diagrama complicado). Esta propriedade mapeia para a tag HTML LongDesc e para a tag Scalable Vetor Graphics (SVG) Desc. Os desenvolvedores que trabalham com controles de imagem devem oferecer suporte a uma propriedade para permitir que a descrição visual seja definida no controle. Essa propriedade deve ser mapeada para a propriedade Automação da Interface do Usuário VisualDescription.
UIA_IsContentElementPropertyId Ver notas. 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 contiver informações significativas ainda não expostas ao usuário final.
UIA_IsControlElementPropertyId VERDADEIRO O controle de imagem é sempre incluído na visualização de controle da árvore de automação da interface do usuário.
UIA_IsKeyboardFocusablePropertyId Ver notas. Se o controle pode receber foco do teclado, ele deve suportar essa propriedade.
UIA_ItemStatusPropertyId Ver notas. 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 suportar a propriedade status e gerar notificações apropriadas quando o status for alterado. Se uma imagem for um controle autônomo e estiver transmitindo status, essa propriedade deverá ser suportada.
UIA_LabeledByPropertyId Ver notas. Se houver um rótulo de texto estático, essa propriedade deve expor uma referência a esse controle.
UIA_LocalizedControlTypePropertyId Ver notas. Cadeia de caracteres localizada correspondente ao tipo de controle Image. O valor padrão é "image" para en-US ou inglês (Estados Unidos).
UIA_NamePropertyId Ver notas. A propriedade Name deve ser exposta para todos os controles de imagem que contêm informações. O acesso programático a esta informação requer que seja fornecido um texto equivalente ao gráfico. Se o controle de imagem for puramente decorativo, ele só deve aparecer na visualização de controle da árvore de automação da interface do usuário e não é necessário ter um nome (consulte Comentários). As estruturas de interface do usuário devem oferecer suporte a uma ALT ou propriedade de texto alternativo em imagens que podem ser definidas de 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 serem suportados para controles de imagem. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.

Padrão de controle Suporte Observações
IGridItemProvider Depende O controle de imagem suporta o 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á oferecer suporte a um tipo de controle que ofereça suporte ao padrão de controle Invoke, como o Button tipo de controle. 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 de automação da interface do usuário.
ISelectionItemProvider Nunca Os controles de imagem não devem oferecer suporte ao padrão de controle SelectionItem. Se as imagens fizerem parte de um contêiner selecionável, como um botão que tenha um ícone de imagem como conteúdo, esse contêiner suportará o padrão, não a imagem dentro.
ITableItemProvider Depende O controle de imagem suporta o padrão de controle TableItem se o controle estiver dentro de um contêiner que tenha controles de cabeçalho.

Eventos necessá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 obter mais informações sobre eventos, consulte 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 oferecer suporte à propriedadeIsEnabled, ele deverá oferecer suporte a esse evento.
UIA_IsOffscreenPropertyId evento de alteração de propriedade. Se o controle oferecer suporte à propriedade IsOffscreen, ele deverá oferecer suporte a esse evento.
UIA_ItemStatusPropertyId evento de alteração de propriedade. Se o controle oferecer suporte à propriedadeItemStatus, ele deverá oferecer suporte a esse evento.
UIA_NamePropertyId evento de alteração de propriedade.
UIA_StructureChangedEventId

Comentários

O World Wide Web Consortium (W3C) 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 do W3C sobre imagens decorativas.

Com relação à automação da interface do usuário:

  • Se uma imagem é puramente decorativa, não é interativa e não transmite nenhuma informação, a imagem:
    • Pode ou não estar na árvore UIA
    • Pode ou não estar na exibição bruta da UIA
    • Não deve estar na exibição de controle UIA
    • Não deve estar na visualização de conteúdo
    • Pode ou não ter um nome
  • Se uma imagem transmite informação, mas há texto claramente associado que fornece a mesma informação (como um botão de reprodução que contém um gráfico de triângulo apontando para a esquerda junto com o texto "play"), a imagem é considerada decorativa e a imagem:
    • Deve estar na visualização bruta
    • Deve estar na visualização de controle
    • Não deve estar na visualizaçã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 visualização de conteúdo
  • Se uma imagem é informativa e transmite detalhes que não são fornecidos por qualquer texto associado, a imagem:
    • Deve estar na visualização bruta
    • Deve estar na visualização de controle
    • Deve estar na visualização de conteúdo
    • Deve ter um valor de nome que descreva a imagem e seu significado

Conceptual

  • Visão geral dos tipos de controle de automação da interface do UI
  • Visão geral da automação da interface do usuário do