Condividi tramite

Tipo di controllo ProgressBar

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente 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 che viene riempito gradualmente con il colore di sistema durante l'esecuzione dell'operazione.

Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo ProgressBar. I requisiti Automazione interfaccia utente si applicano a tutti i controlli indicatore di stato in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli barra di stato e descrive cosa può essere contenuto in ogni visualizzazione. Per altre 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 dispongono di elementi figlio nella visualizzazione controllo o contenuto dell'albero Automazione interfaccia utente.

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per le barre di stato. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Recupero di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente 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 Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue hit testing specializzati, esegue l'override e fornisce un punto selezionabile.
UIA_ControlTypePropertyId ProgressBar
UIA_IsContentElementPropertyId TRUE Il controllo indicatore di stato viene sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente.
UIA_IsControlElementPropertyId TRUE Il controllo indicatore di stato è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente.
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId Vedere le note. Se è presente un'etichetta di testo statico, 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 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.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per 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
IRangeValueProvider Dipende da I controlli indicatore di stato che accettano un intervallo numerico devono implementare il pattern di controllo RangeValue .
Minimo Dipende da Il valore di questa proprietà è il valore minimo su cui è possibile impostare il controllo. Questo valore deve essere minore di Maximum.
Massimo Dipende da Il valore di questa proprietà è il valore massimo su cui è possibile impostare il controllo. Questo valore deve essere maggiore di Minimum.
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 da 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 in formato testuale di un controllo indicatore di stato.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare le barre di stato. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

evento Automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica della proprietà.
UIA_IsEnabledPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica della proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_NamePropertyId evento di modifica della proprietà.
UIA_StructureChangedEventId
UIA_RangeValueValuePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo RangeValue , deve supportare questo evento.
UIA_ValueValuePropertyId evento di modifica della proprietà. Se il controllo supporta il pattern di controllo Value , deve supportare questo evento.

 

Informazioni concettuali

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente