Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
In questo argomento vengono fornite informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo Window. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.
Il controllo finestra è costituito dalla cornice della finestra, che contiene oggetti figlio, tra cui la barra del titolo, il client e altri oggetti.
La requisiti di automazione interfaccia utente nelle sezioni seguenti si applicano a tutti i controlli che implementano il tipo di controllo Window, indipendentemente da Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la vista controllo e la vista contenuto dell'albero di Automazione dell'interfaccia utente relativa ai controlli delle finestre e descrive cosa può essere contenuto in ciascuna vista. Per ulteriori informazioni sull'albero di automazione dell'interfaccia utente, vedere Panoramica dell'albero di automazione interfaccia utente.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Finestra | Finestra |
Proprietà di automazione interfaccia utente necessarie
Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli finestra. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Il controllo finestra deve avere un punto cliccabile che permetterà di selezionare o deselezionare la finestra. |
| ControlTypeProperty | Finestra | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| IsContentElementProperty | Vero | Il controllo della finestra deve essere sempre soddisfatto. |
| IsControlElementProperty | Vero | Il controllo della finestra deve essere sempre un controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| LabeledByProperty | null |
I controlli della finestra non dispongono di un'etichetta della finestra statica. |
| LocalizedControlTypeProperty | finestra | Stringa localizzata corrispondente al tipo di controllo Window. |
| NameProperty | Vedere le note. | Il controllo finestra contiene sempre un elemento Window primario correlato a ciò che l'utente assocerebbe come identificatore semantico più importante per l'elemento. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati dai controlli finestra. 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 | Assistenza | Note |
|---|---|---|
| IDockProvider | Condizionale | Deve assolutamente essere supportato se la finestra ha la capacità di essere ancorata. |
| ITransformProvider | Obbligatorio | Consente di spostare, ridimensionare o ruotare la finestra sullo schermo. |
| IWindowProvider | Obbligatorio | Abilita operazioni specifiche per la finestra. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli finestra. Per ulteriori informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| AsyncContentLoadedEvent | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| LayoutInvalidatedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà NameProperty. | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà HorizontallyScrollableProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà HorizontalScrollPercentProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà HorizontalViewSizeProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticalScrollPercentProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticallyScrollableProperty. | Dipende da | Nessuno |
| Evento di cambiamento della proprietà VerticalViewSizeProperty. | Dipende da | Nessuno |
| WindowClosedEvent | Obbligatorio | Nessuno |
| WindowOpenedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà WindowVisualStateProperty. | Dipende da | Nessuno |