Tipo di controllo finestra
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Window.
Il controllo finestra è costituito dalla cornice della finestra, che contiene oggetti figlio, ad esempio barra del titolo, oggetti client e altri oggetti.
Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli di controllo e gli eventi necessari per il tipo di controllo Finestra. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli finestra in cui il framework dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Argomenti correlati
Struttura ad albero tipica
La tabella seguente illustra una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli finestra e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli finestra. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| 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. | Il controllo finestra deve avere un punto selezionabile che causa l'opzione selezionata o non selezionata dalla finestra. |
| UIA_ControlTypePropertyId | Window | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| UIA_IsContentElementPropertyId | TRUE | Il controllo finestra è sempre incluso nella visualizzazione contenuto dell'albero Automazione interfaccia utente. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo finestra è 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 | NULL | I controlli finestra non hanno un'etichetta di finestra statica. |
| UIA_LocalizedControlTypePropertyId | Vedere le note. | Stringa localizzata corrispondente al tipo di controllo Window . Il valore predefinito è "window" per en-US o inglese (Stati Uniti). |
| UIA_NamePropertyId | Vedere le note. | Il controllo finestra contiene sempre un elemento della finestra primaria che si riferisce a ciò che l'utente associa come identificatore semantico per l'elemento. |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo Automazione interfaccia utente necessari per essere supportati dai controlli finestra. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo/proprietà del pattern | Supporto/valore | Note |
|---|---|---|
| IDockProvider | Condizionale | Il modello di controllo Dock deve essere supportato se la finestra può essere ancorata. |
| ITransformProvider | Necessario | Il modello di controllo Trasforma consente di spostare, ridimensionare o ruotare la finestra sullo schermo. (Non si applica alle app di Windows Store). |
| IWindowProvider | Necessario | Il modello di controllo Finestra consente operazioni specifiche per la finestra. |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente necessari per il supporto dei controlli Finestra. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Automazione interfaccia utente evento | Note |
|---|---|
| UIA_AsyncContentLoadedEventId | |
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento modificato dalla proprietà. | |
| UIA_IsEnabledPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento modificato dalla proprietà. | Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento. |
| UIA_LayoutInvalidatedEventId | |
| UIA_NamePropertyId evento di modifica della proprietà. | |
| 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 | |
| UIA_Window_WindowClosedEventId | |
| UIA_Window_WindowOpenedEventId | |
| UIA_WindowWindowVisualStatePropertyId evento di modifica della proprietà. | Se il controllo supporta la proprietà WindowVisualState del pattern di controllo Window , questo evento deve essere supportato. |
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente