Supporto per automazione interfaccia utente del tipo di controllo Image
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 immagine. 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 linee guida specifiche per la struttura ad albero di Automazione interfaccia utente, i valori delle proprietà di Automazione interfaccia utente e i criteri di controllo.
I controlli Image usati come icone, grafica informativa e grafici supportano il tipo di controllo Image. I controlli usati come immagini di sfondo o filigrana non supportano il tipo di controllo Image.
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 immagine. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli immagine, 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 immagine 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 |
|---|---|
| Image | Immagine (a seconda che l'immagine contenga informazioni (in base al valore della proprietà IsContentElement )) |
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo immagine. 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. | Il punto selezionabile del controllo immagine deve essere un punto all'interno del rettangolo di delimitazione del controllo immagine. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | 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 controlli dell'albero di Automazione interfaccia utente e non deve necessariamente avere un nome. 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à Nome Automazione interfaccia utente. |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statico, questa proprietà deve esporre un riferimento a tale controllo. |
| ControlTypeProperty | Image | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "image" | Stringa localizzata corrispondente al tipo di controllo Image. |
| IsContentElementProperty | Vedere le note. | Il controllo immagine deve essere incluso nella visualizzazione contenuto dell'albero di Automazione interfaccia utente quando contiene informazioni significative non ancora esposte all'utente finale. |
| IsControlElementProperty | Vero | Il controllo immagine è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| HelpTextProperty | Vedere le note. | La proprietà HelpText espone una stringa localizzata che descrive l'aspetto visivo effettivo del controllo (ad esempio, un quadrato rosso con una 'X' bianca) o altre informazioni sulla descrizione comandi associate all'immagine. Questa proprietà deve essere supportata quando è necessaria una descrizione lunga per fornire altre informazioni sul controllo immagine, ad esempio in un grafico o diagramma complesso. Questa proprietà esegue il mapping al tag HTML LongDesc e al tag Scalable Vector Graphics (SVG) Desc. Gli strumenti di sviluppo che usano i controlli immagine devono supportare una proprietà che consenta la descrizione visiva da impostare per il controllo. È necessario eseguire il mapping di questa proprietà alla proprietà VisualDescription di automazione interfaccia utente. |
| ItemStatusProperty | 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 in un elemento, tale elemento deve supportare la proprietà Status e generare le notifiche appropriate quando lo stato viene modificato. Se un'immagine è un controllo autonomo che visualizza lo stato, questa proprietà deve essere supportata. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di Automazione interfaccia utente che devono essere supportati da tutti i controlli immagine. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IGridItemProvider | Dipende da | Se il controllo si trova all'interno di un contenitore della griglia, il controllo immagine supporta il pattern GridItem. |
| ITableItemProvider | Dipende da | Se il controllo si trova all'interno di un contenitore con controlli intestazione, il controllo immagine supporta il pattern TableItem. |
| IInvokeProvider | Mai | Se il controllo immagine contiene un'immagine selezionabile, il controllo deve supportare un tipo di controllo che supporta il pattern Invoke, ad esempio il tipo di controllo Button. |
| ISelectionItemProvider | Mai | I controlli immagine non devono supportare il pattern SelectionItem. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli immagine. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvokedEvent | Mai | None |
| ElementAddedToSelectionEvent | Mai | None |
| ElementRemovedFromSelectionEvent | Mai | None |
| ElementSelectedEvent | Mai | None |
| 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 |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |