Tipo di controllo riquadro
In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Pane.
Il tipo di controllo Pane è 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 il contenuto del riquadro corrente. I controlli riquadro rappresentano un livello di raggruppamento inferiore a finestre o documenti, ma al di sopra dei singoli controlli. L'utente si sposta tra i riquadri premendo TAB, F6 o CTRL+TAB, a seconda del contesto.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari Automazione interfaccia utente per il tipo di controllo Riquadro. I requisiti Automazione interfaccia utente si applicano a tutti i controlli del riquadro in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Pattern di controllo obbligatori
- Eventi obbligatori
- Esempio di tipo di controllo Pane
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra un controllo e una visualizzazione contenuto tipici della struttura ad albero Automazione interfaccia utente relativa ai controlli riquadro e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Un controllo riquadro viene sempre visualizzato nelle visualizzazioni controllo e contenuto. Non esporre un oggetto layout come riquadro nel controllo o nella visualizzazione contenuto se l'oggetto viene utilizzato solo per la presentazione visiva.
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà 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 di proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| UIA_AccessKeyPropertyId | Vedere le note. | Se una combinazione di tasti specifica fornisce 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 Automazione interfaccia utente. |
| UIA_BoundingRectanglePropertyId | Vedere le note. | Il 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 assuma lo stato attivo quando viene selezionato. |
| 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 è correlato ad altri fotogrammi. Una descrizione è necessaria se lo scopo e la relazione dei frame non sono chiari dal valore della proprietà UIA_NamePropertyId . |
| UIA_IsContentElementPropertyId | TRUE | Il controllo riquadro è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo riquadro è sempre incluso nella visualizzazione controllo dell'albero Automazione interfaccia utente. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, 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 statico, l'etichetta deve essere esposta tramite questa proprietà. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Pane . Il valore predefinito è "pane" 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. |
Pattern di controllo obbligatori
Nella tabella seguente sono elencati i pattern di controllo Automazione interfaccia utente necessari per essere supportati dai controlli riquadro. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto | Note |
|---|---|---|
| IDockProvider | Dipende da | Implementare il pattern di controllo Dock se il controllo riquadro può essere ancorato. |
| IScrollProvider | Dipende da | Implementare il pattern di controllo Scroll se è possibile scorrere il controllo riquadro. |
| ITransformProvider | Dipende da | 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 Window . |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per supportare i controlli del riquadro. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| evento Automazione interfaccia utente | Note |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica della proprietà. | |
| UIA_IsOffscreenPropertyId evento di modifica della proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_ScrollHorizontallyScrollablePropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollHorizontalScrollPercentPropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollHorizontalViewSizePropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticallyScrollablePropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticalScrollPercentPropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_ScrollVerticalViewSizePropertyId evento di modifica della proprietà. | Se il controllo supporta il pattern di controllo Scroll , deve supportare questo evento. |
| UIA_StructureChangedEventId |
Esempio di tipo di controllo Pane
L'immagine seguente illustra un controllo che implementa il tipo di controllo Pane .
| albero Automazione interfaccia utente- Visualizzazione controllo | albero Automazione interfaccia utente: visualizzazione contenuto |
|---|---|
|
|
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per