Tipo di controllo personale

  • Articolo

Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Thumb.

I controlli Thumb forniscono la funzionalità che consente lo spostamento o il trascinamento di un controllo, ad esempio un pulsante della barra di scorrimento, oppure il ridimensionato, ad esempio un widget per il ridimensionamento della finestra. Si noti che un controllo pollice non fornisce funzionalità di trascinamento e rilascio. I controlli pollice possono ricevere lo stato attivo del mouse ma non lo stato attivo della tastiera. Lo sviluppatore del controllo deve implementare il controllo in modo che funzioni nel modo appropriato, ovvero possa essere trascinato o ridimensionato.

Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Thumb. I requisiti di Automazione interfaccia utente applicano tutti i controlli personale in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli personale e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Thumb
 (Non applicabile)

 

I controlli pollice non vengono mai visualizzati nella visualizzazione contenuto perché esistono solo per essere modificati con un mouse. Vengono esposti anche se un altro modello di controllo, ad esempio il modello di controllo Scroll , il modello di controllo Trasforma o Il modello di controllo RangeValue , è supportato nel contenitore del controllo personale.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli personale. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Punto all'interno dell'area client visibile del controllo personale.
UIA_ControlTypePropertyId Pollice
UIA_IsContentElementPropertyId FALSE Il controllo pollice non è mai incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo pollice è sempre incluso nella visualizzazione del controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. Un controllo personale può ricevere lo stato attivo se viene usato come oggetto "gripper" per ridimensionare una finestra o un riquadro. Un controllo personale in un dispositivo di scorrimento o una barra di scorrimento non dovrebbe mai ricevere lo stato attivo.
UIA_LabeledByPropertyId NULL I controlli Thumb non includono mai un'etichetta.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Thumb . Il valore predefinito è "thumb" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId NULL Poiché il controllo pollice non è disponibile nella visualizzazione contenuto dell'albero Automazione interfaccia utente, non richiede un nome.

 

Modelli di controllo obbligatori

Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati dai controlli personale. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Supporto Note
ITransformProvider Necessario Consente lo spostamento del controllo Thumb sullo schermo. Poiché il controllo pollice in genere non può essere ridimensionato o ruotato, il modello di controllo Trasforma supporta principalmente la funzione Move .

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli personale. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_StructureChangedEventId

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente