Supporto per l'automazione interfaccia utente del tipo di controllo Thumb
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Thumb. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
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. È possibile implementare i controlli Thumb anche come bordi mobili dei riquadri. Si noti che questo controllo non fornisce funzionalità di trascinamento della selezione. I controlli Thumb possono ricevere lo stato attivo tramite il mouse, ma in genere non lo stato attivo tramite la 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, le proprietà, i modelli di controllo e gli eventi di Automazione interfaccia utente previsti per il tipo di controllo Thumb. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli thumb, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli thumb e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Visualizzazione di anteprima | - Non applicabile |
I controlli Thumb non vengono mai visualizzati nella visualizzazione contenuto perché possono essere modificati solo con il mouse. La relativa funzionalità viene esposta anche se un altro pattern di controllo, ad esempio Scroll, Transform o RangeValue, è supportato nel contenitore Thumb.
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli thumb. Per maggiori informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Qualsiasi punto all'interno dell'area client visibile del controllo Thumb. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Null |
Il controllo Thumb non è disponibile nella visualizzazione contenuto dell'albero di automazione interfaccia utente e pertanto non richiede un nome. |
| LabeledByProperty | Null |
I controlli Thumb non includono mai un'etichetta. |
| ControlTypeProperty | Visualizzazione di anteprima | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "thumb" | Stringa localizzata corrispondente al tipo di controllo Thumb. |
| IsContentElementProperty | Falso | Il controllo Thumb non è mai un contenuto. |
| IsControlElementProperty | Vero | Il controllo Thumb deve essere sempre un controllo. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli thumb. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| ITransformProvider | Richiesto | Consente lo spostamento del controllo Thumb sullo schermo. |
Eventi di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli thumb. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |