Tipo di controllo immagine
In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Image.
I controlli immagine usati come icone, grafica informativa e grafici supporteranno il tipo di controllo Immagine . I controlli usati come immagini di sfondo o filigrana non supporteranno il tipo di controllo Immagine .
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 Image. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli immagine 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
- Proprietà pertinenti
- Pattern di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente che riguarda i controlli immagine 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 |
|---|---|
| Immagine | Immagine (dipende dal fatto che l'immagine contenga informazioni, in base al valore della proprietà Identificatori proprietà elemento di Automazione ) |
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli immagine. 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. | Il punto selezionabile del controllo immagine deve essere un punto all'interno del rettangolo di delimitazione del controllo immagine. |
| UIA_ControlTypePropertyId | Immagine | |
| UIA_HelpTextPropertyId | Vedere le note. | La proprietà HelpText espone una stringa localizzata che descrive l'aspetto visivo effettivo del controllo o altre informazioni sulla descrizione comando associate all'immagine. Questa proprietà deve essere supportata quando è necessaria una descrizione lunga per fornire altre informazioni sul controllo immagine, ad esempio se l'immagine è un grafico o un diagramma complicato. Questa proprietà esegue il mapping al tag LongDesc HTML e al tag Desc Scalable Vector Graphics (SVG). Gli strumenti di sviluppo che usano i controlli immagine devono supportare una proprietà che consenta la descrizione visiva da impostare per il controllo. Questa proprietà deve essere mappata alla proprietà Automazione interfaccia utente VisualDescription. |
| UIA_IsContentElementPropertyId | Vedere le note. | Il controllo immagine deve essere incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente quando contiene informazioni significative non già esposte all'utente finale. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo immagine è 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_ItemStatusPropertyId | Vedere le note. | Se il controllo immagine rappresenta le informazioni sullo stato relative a un particolare elemento sullo schermo, il controllo deve essere contenuto all'interno dell'elemento. Quando l'immagine è contenuta all'interno di un elemento, l'elemento deve supportare la proprietà di stato e generare notifiche appropriate quando lo stato cambia. Se un'immagine è un controllo autonomo che visualizza lo stato, questa proprietà deve essere supportata. |
| 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 Image . Il valore predefinito è "image" per en-US o english (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | La proprietà Name deve essere esposta per tutti i controlli immagine che contengono informazioni. L'accesso a livello di codice a queste informazioni richiede che venga specificato un equivalente testuale dell'immagine. Se il controllo immagine è puramente decorativo, deve essere visualizzato solo nella visualizzazione controllo dell'albero Automazione interfaccia utente e non è necessario avere un nome (vedere la sezione Osservazioni). I framework dell'interfaccia utente devono supportare una proprietà ALT o testo alternativo sulle immagini, in grado di essere impostata dall'interno del relativo framework. Questa proprietà verrà quindi mappata alla proprietà Automazione interfaccia utente Name. |
Pattern di controllo obbligatori
Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per essere supportati per i controlli immagine. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto | Note |
|---|---|---|
| IGridItemProvider | Dipende da | Il controllo immagine supporta il pattern di controllo GridItem se il controllo si trova all'interno di un contenitore della griglia. |
| IInvokeProvider | Mai | Se il controllo immagine è un oggetto selezionabile, il controllo deve supportare un tipo di controllo che supporta il pattern di controllo Invoke , ad esempio il tipo di controllo Button . Per un oggetto immagine che contiene più oggetti selezionabili, l'elemento (tipo di controllo Immagine) può ospitare collegamenti figlio (tipo di controllo Hyperlink) nell'albero Automazione interfaccia utente. |
| ISelectionItemProvider | Mai | I controlli Immagine non devono supportare il pattern di controllo SelectionItem . Se le immagini fanno parte di un contenitore selezionabile, ad esempio un pulsante con un'icona di immagine come contenuto, tale contenitore supporta il modello, non l'immagine all'interno. |
| ITableItemProvider | Dipende da | Il controllo immagine supporta il pattern di controllo TableItem se il controllo si trova all'interno di un contenitore con controlli intestazione. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli immagine. 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_ItemStatusPropertyId evento di modifica della proprietà. | Se il controllo supporta la proprietà ItemStatus , deve supportare questo evento. |
| UIA_NamePropertyId evento di modifica della proprietà. | |
| UIA_StructureChangedEventId |
Commenti
World Wide Web Consortium (W3C) definisce un'immagine decorativa come una che non aggiunge informazioni al contenuto di una pagina. Per altri dettagli, vedere l'argomento W3C sulle immagini decorative.
Per quanto riguarda Automazione interfaccia utente:
- Se un'immagine è puramente decorativa, non è interattiva e non trasmette informazioni, l'immagine:
- Potrebbe essere o meno presente nell'albero dell'interfaccia utente
- Potrebbe essere o meno presente nella visualizzazione non elaborata dell'interfaccia utente
- Non deve trovarsi nella visualizzazione del controllo UIA
- Non deve trovarsi nella visualizzazione contenuto
- Potrebbe o non avere un nome
- Se un'immagine trasmette informazioni, ma c'è testo chiaramente associato che fornisce le stesse informazioni (ad esempio un pulsante di riproduzione che contiene un elemento grafico triangolo a sinistra insieme al testo "play"), l'immagine viene considerata decorativa e l'immagine:
- Deve trovarsi nella visualizzazione non elaborata
- Deve trovarsi nella visualizzazione controlli
- Non deve trovarsi nella visualizzazione contenuto
- Potrebbe o non avere un valore nella proprietà Name
- Il testo che trasmette anche il significato dell'immagine deve essere nella visualizzazione contenuto
- Se un'immagine è informativa e trasmette dettagli non forniti da alcun testo associato, l'immagine:
- Deve trovarsi nella visualizzazione non elaborata
- Deve trovarsi nella visualizzazione controlli
- Deve trovarsi nella visualizzazione contenuto
- Deve avere un valore name che descrive l'immagine e il suo significato