Supporto per automazione interfaccia utente del tipo di controllo ListItem
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 ListItem. 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 elemento elenco sono un esempio di controlli che implementano il tipo di controllo ListItem.
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 ListItem. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli elenco, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli elemento elenco e descrive cosa può essere contenuto in ogni vista. Per maggiori informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell’albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| ListItem - Immagine (0 o più) - Testo (0 o più) - Modifica (0 o più) |
ListItem |
Gli elementi figlio di un controllo elemento elenco all'interno della vista contenuto dell'albero di Automazione interfaccia utente deve sempre essere "0". Se la struttura del controllo è tale che altri elementi siano contenuti sotto l'elemento di elenco, è necessario rispettare i requisiti per il tipo di controllo supporto di Automazione interfaccia utente per il tipo di controllo TreeItem.
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli elemento elenco. 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 valore di questa proprietà include l'area dei contenuti immagine e testo dell'elemento dell'elenco. |
| ClickablePointProperty | Dipende da | Se l'elenco ha un punto selezionabile ovvero un punto su cui è possibile fare clic affinché l'elenco assuma lo stato attivo, tale punto deve essere esposto tramite questa proprietà. Se l'elenco è completamente coperto da elementi elenco discendenti, verrà generata un'eccezione NoClickablePointException per indicare che il client deve richiedere un elemento all'interno dell'elenco come punto selezionabile. |
| NameProperty | Vedere le note. | Il valore della proprietà name di un controllo elemento elenco deriva dal contenuto di testo dell'elemento. |
| LabeledByProperty | Vedere le note. | Se è presente un'etichetta di testo statico, questa proprietà deve esporre un riferimento a tale controllo. |
| ControlTypeProperty | ListItem | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "list item" | Stringa localizzata corrispondente al tipo di controllo ListItem. |
| IsContentElementProperty | Vero | Il controllo elenco è sempre incluso nella vista contenuto dell'albero di Automazione interfaccia utente. |
| IsControlElementProperty | Vero | Il controllo elenco è sempre incluso nella vista controllo dell'albero di Automazione interfaccia utente. |
| IsKeyboardFocusableProperty | Vero | Se il contenitore può accettare input da tastiera, il valore di questa proprietà deve essere True. |
| HelpTextProperty | "" | Il testo della Guida per gli elenchi deve spiegare il motivo per cui all'utente viene chiesto di effettuare una selezione da un elenco di opzioni, che è in genere lo stesso tipo di informazioni visualizzate tramite una descrizione comando. Ad esempio, "Selezionare un'opzione per impostare la risoluzione dello schermo". |
| ItemTypeProperty | Dipende da | Questa proprietà deve essere esposta per i controlli elemento elenco che rappresentano un oggetto sottostante. In genere, questi controlli elemento elenco includono un'icona associato al controllo che gli utenti associano all'oggetto sottostante. |
| IsOffscreenProperty | Dipende da | Questa proprietà deve restituire un valore indicante se l'elemento elenco viene attualmente visualizzato tramite scorrimento all'interno del contenitore padre che implementa il pattern di controllo Scroll. |
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 dai controlli elemento menu. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| ISelectionItemProvider | Sì | Il controllo elemento elenco deve implementare questo pattern di controllo. Ciò consente ai controlli elemento elenco di indicare quando sono selezionati. |
| IScrollItemProvider | Dipende da | Se l'elemento elenco è contenuto in un contenitore scorrevole, è necessario implementare questo pattern di controllo. |
| IToggleProvider | Dipende da | Se l'elemento elenco è selezionabile e l'azione non comporta una modifica dello stato di selezione, è necessario implementare questo pattern di controllo. |
| IExpandCollapseProvider | Dipende da | Se l'elemento può essere modificato per visualizzare o nascondere informazioni, è necessario implementare questo pattern di controllo. |
| IValueProvider | Dipende da | Se l'elemento può essere modificato, è necessario implementare questo pattern di controllo. Le modifiche al controllo elemento elenco vengono apportate modifiche ai valori di NamePropertye Value. |
| IGridItemProvider | Dipende da | Se è supportato lo spostamento spaziale tra elementi all'interno del contenitore elenco e il contenitore è organizzato in righe e colonne, è necessario implementare il pattern di controllo GridItem. |
| IInvokeProvider | Dipende da | Se l'elemento include un comando che può essere eseguito su di esso, oltre alla selezione, è necessario implementare questo pattern. In genere si tratta di un'azione associata all'esecuzione del doppio clic sul controllo elemento elenco. Ad esempio l'avvio di un documento da Microsoft Windows Explorer o la riproduzione di un file musicale in Microsoft Windows Media Player. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli elemento elenco. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvokedEvent | Dipende da | None |
| ElementAddedToSelectionEvent | Richiesto | None |
| ElementRemovedFromSelectionEvent | Richiesto | None |
| ElementSelectedEvent | Richiesto | 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 |
| NameProperty | Richiesto | None |
| Evento di modifica della proprietàItemStatusProperty . | Dipende da | None |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Dipende da | None |
| Evento di modifica della proprietàValueProperty . | Dipende da | None |
| Evento di modifica della proprietàToggleStateProperty . | Dipende da | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |