Condividi tramite

Tipo di controllo immagine

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo Image.

I controlli immagine usati come icone, grafica informativa e grafici supporteranno il tipo di controllo image. I controlli usati come immagini di sfondo o filigrana non supporteranno il tipo di controllo immagine.

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 Image. I requisiti di automazione interfaccia utente si applicano a tutti i controlli immagine 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

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di 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 ui Automation Tree Overview.

Visualizzazione controllo Visualizzazione contenuto
Immagine Immagine (dipende dal fatto che l'immagine contenga informazioni, in base al valore della proprietà dell'elemento di automazione)

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà di 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 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. 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 svg (Scalable Vector Graphics) Desc. Gli sviluppatori che utilizzano i controlli immagine devono supportare una proprietà per consentire l'impostazione della descrizione visiva nel controllo. Questa proprietà deve essere mappata alla proprietà di automazione interfaccia utente VisualDescription.
UIA_IsContentElementPropertyId Vedere le note. Il controllo immagine deve essere incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente quando contiene informazioni significative non già esposte all'utente finale.
UIA_IsControlElementPropertyId VERO Il controllo immagine è 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_ItemStatusPropertyId Vedere le note. Se il controllo immagine rappresenta le informazioni sullo stato di 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 e indica lo stato, questa proprietà deve essere supportata.
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 Image. Il valore predefinito è "image" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. La proprietà Nome deve essere esposta per tutti i controlli immagine che contengono informazioni. L'accesso a livello di codice a queste informazioni richiede che venga fornito un equivalente testuale all'elemento grafico. Se il controllo immagine è puramente decorativo, deve essere visualizzato solo nella visualizzazione controllo dell'albero di automazione interfaccia utente e non è necessario avere un nome (vedere Osservazioni). I framework dell'interfaccia utente devono supportare una proprietà ALT o testo alternativa nelle immagini che possono essere impostate dall'interno del framework. Questa proprietà verrà quindi mappata alla proprietà Ui Automation Name.

Modelli di controllo obbligatori

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati per i controlli immagine. 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 Appoggiare Note
IGridItemProvider Dipende Il controllo immagine supporta il GridItem pattern di controllo se il controllo si trova all'interno di un contenitore 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 pulsante. Per un oggetto immagine che contiene più oggetti selezionabili, l'elemento (tipo di controllo Immagine) può ospitare collegamenti figlio (collegamento ipertestuale tipo di controllo) nell'albero di 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 Il controllo immagine supporta il pattern di controllo TableItem se il controllo si trova all'interno di un contenitore con controlli intestazione.

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli immagine. 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_ItemStatusPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàitemStatus, deve supportare questo evento.
UIA_NamePropertyId evento di modifica delle proprietà.
UIA_StructureChangedEventId

Osservazioni

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 .

Rispetto all'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 o non trovarsi nella visualizzazione non elaborata dell'interfaccia utente
    • Non deve trovarsi nella visualizzazione dei controlli UIA
    • Non deve trovarsi nella visualizzazione contenuto
    • Potrebbe o non avere un nome
  • Se un'immagine trasmette informazioni, ma c'è chiaramente testo 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 trovarsi nella visualizzazione contenuto
  • Se un'immagine è informativa e fornisce 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

Concettuale