Condividi tramite

Supporto per l'Automazione dell'Interfaccia Utente per il controllo di tipo immagine

Annotazioni

Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.

In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo Immagine. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.

I controlli immagine utilizzati come icone, grafica informativa e grafici supporteranno il tipo di controllo immagine. I controlli utilizzati come immagini di sfondo o filigrana non supporteranno il tipo 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, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Form.

Struttura ad albero necessaria per l'automazione UI

La tabella seguente illustra la visualizzazione controlli 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 altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Vista di controllo Visualizzazione contenuto
Immagine Immagine (dipende dal fatto che l'immagine contenga informazioni (in base al valore della IsContentElement proprietà))

Proprietà di automazione interfaccia utente necessarie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo Image. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Ui Automation, proprietà Valore Note
AutomationIdProperty Vedere le note. Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione.
BoundingRectangleProperty Vedere le note. 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 della tastiera, 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 fornito un equivalente testuale all'elemento grafico. Se il controllo immagine è puramente decorativo, deve essere visualizzato solo nella visualizzazione di controllo dell'albero di automazione dell'interfaccia utente e non è necessario avere un nome. 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.
LabeledByProperty Vedere le note. Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo.
ControlTypeProperty Immagine Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
LocalizedControlTypeProperty immagine 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 già esposte all'utente finale.
IsControlElementProperty Vero Il controllo immagine è sempre incluso nella visualizzazione 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 comando associate all'immagine.

Questa proprietà deve essere supportata quando è necessaria una descrizione lunga per fornire altre informazioni sul controllo immagine. Ad esempio, un grafico o un diagramma complicato. Questa proprietà esegue il mapping al tag HTML LongDesc e al tag Desc Scalable Vector Graphics (SVG). 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à VisualDescription dell'Automazione Interfaccia Utente.
ItemStatusProperty 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à status e generare notifiche appropriate quando lo stato cambia.

Se un'immagine è un controllo autonomo e indica lo stato, questa proprietà deve essere supportata.

Modelli di controllo di automazione interfaccia utente necessari

La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli immagine. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.

Pattern di controllo Assistenza Note
IGridItemProvider Dipende da Il controllo immagine supporta il pattern Grid Item se il controllo si trova all'interno di un contenitore a griglia.
ITableItemProvider Dipende da Il controllo immagine supporta il pattern Table Item se il controllo si trova all'interno di un contenitore con controlli di intestazione.
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 modello Elemento di selezione.

Eventi di automazione interfaccia utente necessari

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli immagine. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Assistenza Note
InvokedEvent Mai Nessuno
ElementAddedToSelectionEvent Mai Nessuno
ElementRemovedFromSelectionEvent Mai Nessuno
ElementSelectedEvent Mai Nessuno
Evento di cambiamento della proprietà BoundingRectangleProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsOffscreenProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà IsEnabledProperty. Obbligatorio Nessuno
Evento di cambiamento della proprietà NameProperty. Obbligatorio Nessuno
AutomationFocusChangedEvent Obbligatorio Nessuno
StructureChangedEvent Obbligatorio Nessuno

Vedere anche

  • Last updated on