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 Button. 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, i pattern di controllo e gli eventi di automazione interfaccia utente.
Un pulsante è un oggetto con cui un utente interagisce per eseguire un'azione, ad esempio i pulsanti OK e Annulla in una finestra di dialogo. Il controllo pulsante è un controllo semplice da esporre perché esegue il mapping a un singolo comando che l'utente desidera completare.
Le sezioni seguenti definiscono la struttura ad albero di automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Button. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli dei pulsanti, che siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione controllo e la visualizzazione del contenuto dell'albero di automazione dell'interfaccia utente che riguarda i controlli del pulsante e descrive cosa può essere contenuto in ciascuna visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
| Pulsante - Immagine (0 o più) - Testo (0 o più) |
Pulsante |
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 che implementano il tipo di controllo Button (ad esempio i controlli pulsante). Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AcceleratorKeyProperty | Vedere le note. | Il controllo Pulsante in genere deve supportare un tasto di scelta rapida per permettere all'utente di eseguire rapidamente l'azione che rappresenta tramite la tastiera. |
| 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. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| ControlTypeProperty | Pulsante | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| HelpTextProperty | Vedere le note. | Il testo della Guida può indicare quale sarà il risultato finale dell'attivazione del pulsante. Di solito, si tratta dello stesso tipo di informazioni presentate tramite una descrizione comando. |
| IsContentElementProperty | Vero | Il controllo Button deve sempre avere del contenuto. |
| IsControlElementProperty | Vero | Il Button deve sempre essere un controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| LabeledByProperty | Null |
I controlli pulsante sono auto-etichettati in base al contenuto. |
| LocalizedControlTypeProperty | pulsante | Stringa localizzata corrispondente al tipo di pulsante. |
| NameProperty | Vedere le note. | Il nome del controllo pulsante è il testo usato per etichettarlo. Ogni volta che un'immagine viene usata per etichettare un pulsante, è necessario specificare testo alternativo per la proprietà Name del pulsante. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i pattern di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli pulsante. 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 |
|---|---|---|
| IInvokeProvider | Vedere le note. | Tutti i pulsanti devono supportare il pattern di controllo Invoke o il pattern di controllo Attiva/Disattiva. Invoke è supportato quando il pulsante esegue un comando alla richiesta dell'utente. Questo comando esegue il mapping a una singola operazione, ad esempio Taglia, Copia, Incolla o Elimina. |
| IToggleProvider | Vedere le note. | Tutti i pulsanti devono supportare il pattern di controllo Invoke o il pattern di controllo Attiva/Disattiva. L'interruttore è supportato se il pulsante può passare attraverso una serie di tre stati al massimo. In genere si tratta di un interruttore attivato/disattivato per funzionalità specifiche. |
| IExpandCollapseProvider | Vedere le note. | Quando un pulsante è ospitato come elemento figlio di un pulsante di divisione, il pulsante figlio può supportare il modello ExpandCollapse anziché il modello Invoke o Toggle. Il modello ExpandCollapse può essere utilizzato per aprire o chiudere un menu o un'altra sottostruttura associata all'elemento pulsante. |
Eventi di automazione interfaccia utente necessari
La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per essere supportati da tutti i controlli pulsante. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà NameProperty. | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |
| InvokedEvent | Dipende da | Se il controllo supporta il pattern di controllo Invoke, deve supportare questo evento. |
| Evento di cambiamento della proprietà ToggleStateProperty. | Dipende da | Se il controllo supporta il pattern di controllo Toggle, deve supportare questo evento. |