Supporto di automazione interfaccia utente per il tipo di controllo Pane
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Riquadro. In UI Automation, 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 UI Automation, i valori delle proprietà di UI Automation e i criteri di controllo.
Il tipo di controllo Pane viene usato per rappresentare un oggetto all'interno di una finestra cornice o finestra documento. Gli utenti possono spostarsi tra controlli riquadro e all'interno del contenuto del riquadro corrente, ma non possono spostarsi tra gli elementi in riquadri diversi. In questo modo i controlli riquadro rappresentano un livello di raggruppamento inferiore rispetto alle finestre e documenti, ma superiore ai singoli controlli. L'utente si sposta tra i riquadri premendo TAB, F6 o CTRL+TAB, a seconda del contesto. Il tipo di controllo Pane non richiede metodi di spostamento specifici tramite tastiera.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo Riquadro. I requisiti di UI Automation 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 visualizzazione controllo e la visualizzazione contenuto dell'albero di UI Automation che riguarda i controlli riquadro e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Riquadro | Riquadro |
Proprietà di automazione interfaccia utente obbligatorie
La seguente tabella elenca le proprietà di UI Automation il cui valore o definizione è particolarmente rilevante per i controlli riquadro. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation 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. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | Vedere le note. | Il valore di questa proprietà deve essere sempre un titolo chiaro, conciso e significativo. |
| ClickablePointProperty | Vedere le note. | Questa proprietà espone un punto selezionabile del controllo riquadro che fa sì che il riquadro assuma lo stato attivo quando viene selezionato. |
| LabeledByProperty | Vedere le note. | I controlli riquadro in genere non hanno un'etichetta statica. Se è presente un'etichetta di testo statico, l'etichetta deve essere esposta tramite questa proprietà. |
| ControlTypeProperty | Riquadro | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "pane" | Stringa localizzata corrispondente al tipo di controllo Pane. |
| IsContentElementProperty | Vero | I controlli Riquadro vengono sempre inclusi nella visualizzazione contenuto dell'albero di UI Automation. |
| IsControlElementProperty | Vero | I controlli Riquadro vengono sempre inclusi nella visualizzazione controllo dell'albero di UI Automation. |
| HelpTextProperty | "" | Il testo della Guida per i controlli riquadro deve illustrare la finalità del riquadro e l'interrelazione del riquadro con altri riquadri. La descrizione si rende necessaria se la finalità e la relazione dei riquadri non è evidente in base al valore di NameProperty. " |
| AccessKeyProperty | Vedere le note. | Se una combinazione di tasti specifica sposta lo stato attivo sul riquadro, le informazioni devono essere esposte tramite questa proprietà. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati da tutti i controlli riquadro. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| ITransformProvider | Dipende da | Implementare questo pattern di controllo se il controllo riquadro può essere spostato, ridimensionato o ruotato sullo schermo. |
| IWindowProvider | Mai | Se è necessario implementare questo pattern di controllo, il controllo deve essere basato sul tipo di controllo Window . |
| IDockProvider | Dipende da | Implementare questo pattern di controllo se il controllo riquadro può essere ancorato. |
| IScrollProvider | Dipende da | Implementare questo pattern di controllo se il controllo riquadro supporta lo scorrimento. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli riquadro. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto/valore | Note |
|---|---|---|
| WindowClosedEvent | Mai | None |
| WindowOpenedEvent | Mai | None |
| AsyncContentLoadedEvent | 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 |
| Evento di modifica della proprietàHorizontallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàHorizontalViewSizeProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalScrollPercentProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticallyScrollableProperty . | Dipende da | None |
| Evento di modifica della proprietàVerticalViewSizeProperty . | Dipende da | None |
| Evento di modifica della proprietàWindowVisualStateProperty . | Mai | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |
Esempio di tipo di controllo Pane
Nell'immagine seguente viene illustrato un controllo che implementa il tipo di controllo Pane.
| Albero di UI Automation - Visualizzazione controllo | Albero di UI Automation - Visualizzazione contenuto |
|---|---|
|
- Riquadro - Tree (pattern Scroll) - TreeItem - ...Riquadro - Modifica - (pattern Scroll) |