Supporto per automazione interfaccia utente del tipo di controllo ProgressBar
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.
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente per il tipo di controllo ProgressBar. 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 le linee guida specifiche per la struttura ad albero di Automazione interfaccia utente con i rispettivi valori, i modelli di controllo e gli eventi.
I controlli indicatore di stato sono un esempio di controlli che implementano il tipo di controllo ProgressBar. I controlli indicatore di stato vengono usati per indicare lo stato di avanzamento di un'operazione la cui esecuzione richiede molto tempo. Il controllo è costituito da un rettangolo che viene riempito gradualmente con il colore di sistema durante l'esecuzione dell'operazione.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo ProgressBar. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli elenco, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli barra di stato e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| ProgressBar | ProgressBar |
I controlli indicatore di stato non includono elementi figli nella visualizzazione controlli o nella visualizzazione contenuto dell'albero di Automazione interfaccia utente.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli barra di avanzamento. 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. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il controllo indicatore di stato in genere ricava il proprio nome da un'etichetta di testo statico. Se non è presente alcuna etichetta di testo statico, lo sviluppatore dell'applicazione deve esporre un valore per la proprietà Name . |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statico, questa proprietà deve esporre un riferimento a tale controllo. |
| ControlTypeProperty | ProgressBar | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "progress bar" | Stringa localizzata corrispondente al tipo di controllo ProgressBar. |
| IsContentElementProperty | Vero | Il controllo barra di stato è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo barra di stato è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
Pattern di controllo e proprietà obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati dai controlli barra di stato. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| IValueProvider | Dipende da | Il controllo indicatore di stato che fornisce un'indicazione testuale dello stato di avanzamento deve implementare IValueProvider. |
| IsReadOnly | Vero | Il valore per questa proprietà è sempre True. |
| Value | Vedere le note. | Questa proprietà espone lo stato di avanzamento in formato testuale di un controllo indicatore di stato. |
| IRangeValueProvider | Dipende da | I controlli indicatore di stato che accettano un intervallo numerico devono implementare IRangeValueProvider |
| Minimum | 0.0 | Il valore di questa proprietà è il valore minimo che è possibile impostare per il controllo. |
| Maximum | 100.0 | Il valore di questa proprietà è il valore massimo che è possibile impostare per 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 obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli barra di stato. 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 |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |