Condividi tramite

Supporto per l'automazione della UI per il tipo di controllo Thumb

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono fornite informazioni sul supporto dell'Automazione dell'Interfaccia Utente per il tipo di controllo di pollice. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.

I controlli a pollice permettono di spostare (o trascinare) un controllo, come un pulsante della barra di scorrimento, o ridimensionare, come un widget di ridimensionamento della finestra. I controlli Thumb possono essere implementati anche come bordi mobili dei riquadri. Si noti che non fornisce funzionalità di trascinamento e rilascio. I controlli thumb possono ricevere lo stato attivo del mouse, ma in genere non lo stato attivo della tastiera. Lo sviluppatore del controllo deve implementare il controllo in modo che funzioni in modo appropriato (può essere trascinato o ridimensionato).

Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Thumb. I requisiti dell'automazione dell'interfaccia utente si applicano a tutti i controlli thumb, sia che siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la visualizzazione dei controlli e la visualizzazione dei contenuti dell'albero di automazione dell'interfaccia utente che riguarda i controlli di pollice e descrive cosa può essere contenuto in ciascuna visualizzazione. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.

Vista di controllo Visualizzazione contenuto
Pollice - Non applicabile

I controlli Thumb non vengono mai visualizzati in Visualizzazione contenuto perché esistono solo per essere modificati con un mouse. La loro funzionalità è esposta attraverso un altro pattern di controllo, come lo Scroll Pattern, il Transform Pattern o il RangeValue Pattern, supportato nel contenitore Thumb.

Proprietà di automazione interfaccia utente necessarie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli thumb. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. 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 della tastiera, deve supportare questa proprietà.
NameProperty Null Il controllo Thumb non è disponibile nella visualizzazione dei contenuti dell'albero di automazione dell'interfaccia utente, quindi non richiede un nome.
LabeledByProperty Null I controlli Thumb non hanno mai un'etichetta.
ControlTypeProperty Pollice Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty pollice Stringa localizzata corrispondente al controllo di tipo Thumb.
IsContentElementProperty Falso Il controllo Thumb non è mai soddisfatto.
IsControlElementProperty Vero Il controllo Thumb deve essere sempre un controllo .

Modelli di controllo di automazione interfaccia utente necessari

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati dai controlli thumb. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.

Pattern di controllo/pattern, proprietà Supporto/valore Note
ITransformProvider Obbligatorio Consente di spostare il controllo thumb sullo schermo.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli thumb. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.

Evento di automazione interfaccia utente Assistenza Note
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche