Partilhar via


Tipo de controle de polegar

Este tópico fornece informações sobre o suporte à Automação da Interface do Usuário da Microsoft para o tipo de controle Thumb.

Os controles de polegar fornecem a funcionalidade que permite que um controle seja movido (ou arrastado), como um botão da barra de rolagem, ou redimensionado, como um widget de redimensionamento de janela. Observe que um controle de polegar não fornece a funcionalidade de arrastar e soltar. Os controles de polegar podem receber o foco do mouse, mas não o foco do teclado. O desenvolvedor de controle deve implementar o controle para que ele aja adequadamente (pode ser arrastado ou redimensionado).

As seções a seguir definem a estrutura, as propriedades, os padrões de controle e os eventos necessários da árvore de Automação da Interface do Usuário para o tipo de controle Thumb. Os requisitos de automação da interface do usuário aplicam todos os controles polegar 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 um controle típico e exibição de conteúdo da árvore de automação da interface do usuário que pertence aos controles thumb 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
  • Polegar
(Não aplicável)

 

Os controlos de polegar nunca aparecem na vista de conteúdo porque existem apenas para serem manipulados com um rato. Eles são expostos por meio de outro padrão de controle, como o padrão de controle Scroll, padrão de controle Transform ou padrão de controle RangeValue, sendo suportado no contêiner do controle thumb.

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 controles thumb. 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. Um ponto dentro da área visível do cliente do controle de polegar.
UIA_ControlTypePropertyId Polegar
UIA_IsContentElementPropertyId FALSO O controle de polegar nunca é incluído na exibição de conteúdo da árvore de Automação da Interface do Usuário.
UIA_IsControlElementPropertyId VERDADEIRO O controle polegar é 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. Um controle de polegar pode receber o foco se for usado como um objeto de "garra" para dimensionar uma janela ou um painel. Um controle de polegar em um controle deslizante ou barra de rolagem nunca deve receber o foco.
UIA_LabeledByPropertyId NULO Os controles de polegar nunca têm um rótulo.
UIA_LocalizedControlTypePropertyId Ver notas. Cadeia de caracteres localizada correspondente ao tipo de controle Thumb. O valor padrão é "thumb" para en-US ou inglês (Estados Unidos).
UIA_NamePropertyId NULO Como o controle thumb não está disponível na exibição de conteúdo da árvore de Automação da Interface do Usuário, ele não requer um nome.

 

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 pelos controles thumb. 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
ITransformProvider Necessário Permite que o controle de polegar seja movido na tela. Como o controle de polegar normalmente não pode ser redimensionado ou girado, o padrão de controle Transform suporta principalmente a função Move.

 

Eventos necessários

A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles thumb 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_StructureChangedEventId

 

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