Tipo di controllo ProgressBar
Questo argomento fornisce informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo ProgressBar.
I controlli indicatore di stato indicano lo stato di avanzamento 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 interfaccia utente si applicano a tutti i controlli indicatore di stato in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli indicatore di stato e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
Visualizzazione controlli | Visualizzazione contenuto |
---|---|
|
|
I controlli indicatore di stato non hanno elementi figlio nella visualizzazione controllo o contenuto dell'albero di automazione interfaccia utente.
Proprietà pertinenti
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per le barre di avanzamento. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
Ui Automation, proprietà | 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 di automazione interfaccia utente. |
UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
UIA_ClickablePointPropertyId | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile. |
UIA_ControlTypePropertyId | ProgressBar | |
UIA_IsContentElementPropertyId | TRUE | Il controllo indicatore di stato è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
UIA_IsControlElementPropertyId | TRUE | Il controllo indicatore di stato è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
UIA_LabeledByPropertyId | Vedere le note. | Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. |
UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo ProgressBar. Il valore predefinito è "indicatore di stato" per en-US o inglese (Stati Uniti). |
UIA_NamePropertyId | 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 statico, lo sviluppatore dell'applicazione deve esporre un valore per la proprietà Name. |
Modelli di controllo obbligatori
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/pattern, proprietà | Supporto/valore | Note |
---|---|---|
IRangeValueProvider | Dipende | I controlli indicatore di stato che accettano un intervallo numerico devono implementare il pattern di controllo RangeValue. |
minima | Dipende | Il valore di questa proprietà è il valore minimo su cui è possibile impostare il controllo. Questo valore deve essere minore di Valore massimo. |
massimo | Dipende | Il valore di questa proprietà è il valore massimo su cui è possibile impostare il controllo. Questo valore deve essere maggiore di Minimo. |
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. |
IValueProvider | Dipende | I controlli indicatore di stato che forniscono un'indicazione testuale dello stato di avanzamento devono implementare il pattern di controllo valore. |
IsReadOnly | TRUE | Il valore di questa proprietà è sempre TRUE. |
valore | Vedere le note. | Questa proprietà espone lo stato di avanzamento testuale di un controllo indicatore di stato. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare le barre di stato. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
Evento di automazione interfaccia utente | Note |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
UIA_IsEnabledPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento. |
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
UIA_NamePropertyId evento di modifica delle proprietà. | |
UIA_StructureChangedEventId | |
UIA_RangeValueValuePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo RangeValue, deve supportare questo evento. |
UIA_ValueValuePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Value, deve supportare questo evento. |
Argomenti correlati