Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Aggiornamento: novembre 2007
In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Image. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di 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 pattern di controllo.
I controlli Image utilizzati come icone, grafica informativa e grafici supportano il tipo di controllo Image. Immagini di sfondo e filigrana non supportano il tipo di controllo Image.
Nelle sezioni riportate di seguito vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Image. I requisiti di automazione interfaccia utente si applicano a tutti i controlli immagine, Windows Presentation Foundation (WPF), Win32 o Windows Form.
Nel presente argomento sono contenute le seguenti sezioni.
- Struttura ad albero di automazione interfaccia utente obbligatoria
- Proprietà di automazione interfaccia utente obbligatorie
- Pattern di controllo di automazione interfaccia utente obbligatori
- Eventi di automazione interfaccia utente obbligatori
- Argomenti correlati
Struttura ad albero di automazione interfaccia utente obbligatoria
Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli immagine e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.
Visualizzazione controlli |
Visualizzazione contenuto |
|---|---|
|
|
Proprietà di automazione interfaccia utente obbligatorie
Nella tabella riportata di seguito vengono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i tipi di controllo Image. Per ulteriori 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 per tutti i controlli di un'applicazione. |
Vedere le note. |
Il rettangolo più esterno che contiene l'intero controllo. |
|
Vedere le note. |
Il punto selezionabile del controllo immagine deve essere un punto all'interno del rettangolo di delimitazione del controllo immagine. |
|
Vedere le note. |
Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
|
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 controlli della struttura ad albero di automazione interfaccia utente e non è necessario che disponga di un nome. I framework dell'interfaccia utente devono supportare una proprietà ALT o di testo alternativo sulle immagini che possono essere impostate dall'interno del framework. Questa proprietà eseguirà quindi il mapping alla proprietà Name di automazione interfaccia utente. |
|
Vedere le note. |
Se è presente un'etichetta di testo statica, questa proprietà deve esporre un riferimento a tale controllo. |
|
Image |
Questo valore è identico per tutti i framework dell'interfaccia utente. |
|
"immagine" |
Stringa localizzata che corrisponde al tipo di controllo Image. |
|
Vedere le note. |
Il controllo immagine deve essere incluso nella visualizzazione contenuto della struttura ad albero di automazione interfaccia utente quando contiene informazioni significative non ancora esposte all'utente finale. |
|
True |
Il controllo immagine è sempre incluso nella visualizzazione controlli della struttura ad albero di automazione interfaccia utente. |
|
Vedere le note. |
La proprietà HelpText espone una stringa localizzata che descrive l'aspetto visivo effettivo del controllo (ad esempio un quadrato rosso con un 'X' bianca). Questa proprietà deve essere supportata quando è necessaria una descrizione lunga per fornire ulteriori informazioni sul controllo immagine. Ad esempio, un grafico complicato o un diagramma. Questa proprietà esegue il mapping al tag LongDesc di HTML e al tag Desc di Scalable Vector Graphics (SVG). Gli sviluppatori che utilizzano controlli immagine devono supportare una proprietà per consentire l'impostazione della descrizione sul controllo. Di questa proprietà deve essere eseguito il mapping alla proprietà VisualDescription di automazione interfaccia utente. In genere questa condizione è richiesta quando l'immagine viene utilizzata come controllo contenuto. |
|
Vedere le note. |
Se il controllo immagine rappresenta informazioni sullo stato di un determinato elemento sullo schermo, il controllo deve essere contenuto all'interno dell'elemento. Quando l'immagine è contenuta all'interno di un elemento, tale elemento deve supportare la proprietà dello stato e generare notifiche appropriate quando lo stato viene modificato. Se un'immagine è un controllo autonomo e indica lo stato, questa proprietà deve essere supportata. |
Pattern di controllo di automazione interfaccia utente obbligatori
Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati da tutti i controlli immagine. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.
Pattern di controllo/Proprietà pattern |
Supporto/Valore |
Note |
|---|---|---|
A seconda dei casi |
Il controllo immagine supporta il pattern Grid Item se il controllo è all'interno di un contenitore griglia. |
|
A seconda dei casi |
Il controllo immagine supporta il pattern TableItem se il controllo è all'interno di un contenitore con controlli intestazione. |
|
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. |
|
Mai |
I controlli immagine non devono supportare il pattern SelectionItem. |
Eventi di automazione interfaccia utente obbligatori
Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli immagine. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.
Evento di automazione interfaccia utente |
Supporto |
Note |
|---|---|---|
Mai |
Nessuno |
|
Mai |
Nessuno |
|
Mai |
Nessuno |
|
Mai |
Nessuno |
|
Evento di proprietà modificata BoundingRectangleProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsOffscreenProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata IsEnabledProperty. |
Obbligatorio |
Nessuno |
Evento di proprietà modificata NameProperty. |
Obbligatorio |
Nessuno |
Obbligatorio |
Nessuno |
|
Obbligatorio |
Nessuno |
Vedere anche
Concetti
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Cenni preliminari su automazione interfaccia utente