Tipo di controllo riquadro
In questo argomento vengono fornite informazioni sul supporto di Automazione interfaccia utente Microsoft per il tipo di controllo riquadro.
Il riquadro tipo di controllo è destinato a aree potenzialmente scorrevoli con contenuto diverso. Viene utilizzato per rappresentare un oggetto all'interno di una cornice o di una finestra del documento. Gli utenti possono spostarsi tra i controlli del riquadro e all'interno del contenuto del riquadro corrente. I controlli riquadro rappresentano un livello di raggruppamento inferiore a finestre o documenti, ma sopra i singoli controlli. L'utente si sposta tra riquadri premendo TAB, F6 o CTRL+TAB, a seconda del contesto.
Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il riquadro tipo di controllo. I requisiti di automazione interfaccia utente si applicano a tutti i controlli del riquadro in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.
Questo argomento contiene le sezioni seguenti.
- struttura ad albero tipica
- proprietà rilevanti
- modelli di controllo necessari
- eventi obbligatori
- Esempio di del tipo di controllo riquadro
- argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo tipico e una visualizzazione contenuto dell'albero di automazione interfaccia utente relativo ai controlli riquadro e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Un controllo riquadro viene sempre visualizzato nelle visualizzazioni controllo e contenuto. Non esporre un oggetto layout come riquadro nella visualizzazione controllo o contenuto se l'oggetto viene utilizzato solo per la presentazione visiva.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli riquadro. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| UIA_AccessKeyPropertyId | Vedere le note. | Se una combinazione di tasti specifica assegna lo stato attivo al riquadro, tali informazioni devono essere esposte tramite questa proprietà. |
| UIA_AutomationIdPropertyId | Vedere le note. | Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero di automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| UIA_ClickablePointPropertyId | Vedere le note. | Questa proprietà espone un punto selezionabile del controllo riquadro che fa sì che il riquadro diventi attivo quando viene fatto clic. |
| UIA_ControlTypePropertyId | riquadro | |
| UIA_HelpTextPropertyId | Vedere le note. | Il testo della Guida per i controlli riquadro deve spiegare lo scopo della cornice e il modo in cui si riferisce ad altri fotogrammi. Una descrizione è necessaria se lo scopo e la relazione dei fotogrammi non sono chiari dal valore della proprietà UIA_NamePropertyId. |
| UIA_IsContentElementPropertyId | VERO | Il controllo riquadro è sempre incluso nella visualizzazione contenuto dell'albero di automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | VERO | Il controllo riquadro è sempre incluso nella visualizzazione controllo dell'albero di automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | Vedere le note. | I controlli riquadro in genere non hanno un'etichetta statica. Se è presente un'etichetta di testo statica, deve essere esposta tramite questa proprietà. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo riquadro. Il valore predefinito è "riquadro" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il valore di questa proprietà deve essere sempre un titolo chiaro, conciso e significativo. |
Modelli di controllo obbligatori
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli riquadro. Per altre informazioni sui pattern di controllo, vedere ui Automation Control Patterns Overview.For more information on control patterns, see UI Automation Control Patterns Overview.
| Pattern di controllo | Appoggiare | Note |
|---|---|---|
| IDockProvider | Dipende | Implementare il pattern di controllo dock se il controllo riquadro può essere ancorato. |
| IScrollProvider | Dipende | Implementare il pattern di controllo Scroll se è possibile scorrere il controllo riquadro. |
| ITransformProvider | Dipende | Implementare il pattern di controllo transform se il controllo riquadro può essere spostato, ridimensionato o ruotato sullo schermo. |
| IWindowProvider | Mai | Se l'elemento deve implementare il pattern di controllo Window, il controllo deve essere basato sul tipo di controllo finestra. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli del riquadro. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Note |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica delle proprietà. | |
| UIA_IsOffscreenPropertyId evento di modifica delle proprietà. | Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento. |
| UIA_ScrollHorizontallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_ScrollVerticalViewSizePropertyId evento di modifica delle proprietà. | Se il controllo supporta il pattern di controllo Scroll, deve supportare questo evento. |
| UIA_StructureChangedEventId |
Esempio di tipo di controllo riquadro
L'immagine seguente illustra un controllo che implementa il tipo di controllo riquadro.
| Albero di automazione interfaccia utente- Visualizzazione controllo | Albero di automazione interfaccia utente- Visualizzazione contenuto |
|---|---|
|
|
Argomenti correlati