Supporto per l'automazione interfaccia utente del tipo di controllo Window
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi gestite di Automazione interfaccia utente definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo Window. 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.
Il controllo finestra è costituito dalla cornice della finestra, che contiene oggetti figlio, ad esempio barra del titolo, oggetti client e altri oggetti.
I requisiti di Automazione interfaccia utente nelle sezioni seguenti si applicano a tutti i controlli che implementano il tipo di controllo Window, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli finestra 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 |
|---|---|
| Window | Window |
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 finestra. 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 rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Il controllo finestra deve avere un punto selezionabile che genererà la selezione o deselezione della finestra. |
| ControlTypeProperty | Window | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo finestra deve essere sempre di tipo contenuto. |
| IsControlElementProperty | Vero | Il controllo finestra deve essere sempre un controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| LabeledByProperty | null |
I controlli finestra in genere non hanno un'etichetta statica. |
| LocalizedControlTypeProperty | "window" | Stringa localizzata corrispondente al tipo di controllo Window. |
| NameProperty | Vedere le note. | Il controllo finestra contiene sempre un elemento Window principale che fa riferimento all'elemento associato dall'utente come identificatore più significativo per l'elemento. |
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 finestra. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IDockProvider | Condizionale | Deve essere supportato se la finestra può essere ancorata. |
| ITransformProvider | Richiesto | Abilita lo spostamento, il ridimensionamento o la rotazione della finestra sullo schermo. |
| IWindowProvider | Richiesto | Abilita operazioni specifiche per la finestra. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli finestra. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| AsyncContentLoadedEvent | Richiesto | None |
| AutomationFocusChangedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| LayoutInvalidatedEvent | Richiesto | None |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| StructureChangedEvent | 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 |
| WindowClosedEvent | Richiesto | None |
| WindowOpenedEvent | Richiesto | None |
| Evento di modifica della proprietàWindowVisualStateProperty . | Dipende da | None |