Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 interfaccia utente per il tipo di controllo ProgressBar. 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, i pattern di controllo e gli eventi di automazione interfaccia utente.
I controlli della barra di avanzamento sono un esempio di controlli che implementano il controllo di tipo ProgressBar. I controlli delle barre di avanzamento vengono usati per indicare il progresso di un'operazione lunga. Il controllo è costituito da un rettangolo riempito gradualmente con il colore di evidenziazione del sistema durante l'avanzamento di un'operazione.
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 ProgressBar. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli elenco, sia che si tratti di Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la vista controlli e la vista contenuti dell'albero dell'automazione dell'interfaccia utente relativi al controllo delle barre di avanzamento e descrive cosa può essere contenuto in ogni vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Barra di avanzamento | Barra di avanzamento |
I controlli indicatore di stato non hanno elementi figlio nella visualizzazione controllo o contenuto dell'albero di automazione interfaccia utente.
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 indicatore di stato. 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. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo indicatore di stato ottiene in genere il nome da un'etichetta di testo statica. Se non è presente un'etichetta di testo statica, lo sviluppatore dell'applicazione deve esporre un valore per la Name proprietà . |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. |
| ControlTypeProperty | Barra di avanzamento | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | barra di avanzamento | Stringa localizzata corrispondente al tipo di controllo ProgressBar. |
| IsContentElementProperty | Vero | Il controllo indicatore di stato è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo indicatore di stato è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
Schemi di controllo e proprietà necessari per l'automazione interfaccia utente
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli indicatore di stato. 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/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| IValueProvider | Dipende da | I controlli della barra di avanzamento che forniscono un'indicazione testuale dello stato di avanzamento devono implementare IValueProvider. |
| IsReadOnly | Vero | Il valore di questa proprietà è sempre Vero. |
| Value | Vedere le note. | Questa proprietà espone lo stato di avanzamento testuale di un controllo indicatore di stato. |
| IRangeValueProvider | Dipende da | I controlli barra di avanzamento che accettano un intervallo numerico devono implementare IRangeValueProvider |
| Minimum | 0.0 | Il valore di questa proprietà è il valore più piccolo su cui è possibile impostare il controllo. |
| Maximum | 100.0 | Il valore di questa proprietà è il valore più grande su cui è possibile impostare il controllo. |
| SmallChange | Nan | Questa proprietà non è necessaria perché i controlli indicatore di stato sono di sola lettura. |
| LargeChange | Nan | Questa proprietà non è necessaria perché i controlli indicatore di stato sono di sola lettura. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli indicatore di stato. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| 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 |
| Evento di cambiamento della proprietà NameProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ValueProperty. | Dipende da | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |