Supporto per automazione interfaccia utente del tipo di controllo Button
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di UI Automation gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su UI Automation, vedere API di automazione di Windows: UI Automation.
In questo argomento vengono fornite informazioni sul supporto di UI Automation per il tipo di controllo Pulsante. In UI Automation, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Le condizioni includono le linee guida specifiche per la struttura ad albero di UI Automation con i rispettivi valori, i modelli di controllo e gli eventi.
Un pulsante è un oggetto che un utente usa per eseguire un'azione, ad esempio i pulsanti OK e Annulla in una finestra di dialogo. Il controllo Button è un controllo semplice da esporre perché esegue il mapping a un unico comando che l'utente desidera completare.
Le seguenti sezioni definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di UI Automation necessari per il tipo di controllo Pulsante. I requisiti di UI Automation si applicano a tutti i controlli pulsante, ovvero Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente illustra la visualizzazione controllo e la visualizzazione contenuto dell'albero di UI Automation che riguarda i controlli pulsante e descrive cosa può essere contenuto in ogni visualizzazione. Per maggiori informazioni sull'albero di UI Automation, vedere Panoramica dell’albero di UI Automation.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
| Pulsante - Image (0 o più) - Text (0 o più) |
Pulsante |
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà UI Automation il cui valore o la cui definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo Button, ad esempio i pulsanti. Per maggiori informazioni sulle proprietà di UI Automation, vedere Proprietà di UI Automation per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AcceleratorKeyProperty | Vedere le note. | Il controllo Button in genere deve supportare un tasto di scelta rapida per consentire agli utenti finali di eseguire rapidamente la corrispondente azione usando la tastiera. |
| 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. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| ControlTypeProperty | Pulsante | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| HelpTextProperty | Vedere le note. | Il testo della Guida può indicare il risultato finale dell'attivazione del pulsante. Questo è in genere lo stesso tipo di informazioni visualizzate tramite una descrizione comando. |
| IsContentElementProperty | Vero | Il controllo Button deve essere sempre di tipo contenuto. |
| IsControlElementProperty | Vero | Il controllo Button deve essere sempre un controllo. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| LabeledByProperty | Null |
Ai controlli Button viene automaticamente applicata un'etichetta in base al relativo contenuto. |
| LocalizedControlTypeProperty | "button" | Stringa localizzata corrispondente al tipo di controllo Button. |
| NameProperty | Vedere le note. | Il nome del controllo Button è il testo che viene usato per assegnare un'etichetta al controllo. Ogni volta che viene usata un'immagine per definire l'etichetta di un pulsante, è necessario specificare il testo alternativo per la proprietà Name del pulsante. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La seguente tabella elenca i criteri di controllo di UI Automation che devono essere supportati da tutti i controlli pulsante. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IInvokeProvider | Vedere le note. | Tutti i pulsanti devono supportare il pattern di controllo Invoke o il pattern di controllo Toggle. Il pattern di controllo Invoke è supportato quando il pulsante esegue un comando su 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 Toggle. Il pattern di controllo Toggle è supportato se il pulsante può passare alternativamente tra un massimo di tre stati. In genere viene interpretato come opzione di attivazione/disattivazione per funzionalità specifiche. |
| IExpandCollapseProvider | Vedere le note. | Quando un pulsante viene inserito come figlio di un pulsante di menu combinato, il pulsante figlio può supportare il pattern ExpandCollapse anziché il pattern Invoke o Toggle. Il pattern ExpandCollapse può essere usato per l'apertura o chiusura di un menu o altra sottostruttura associata all'elemento del pulsante. |
Eventi di automazione interfaccia utente obbligatori
La seguente tabella elenca gli eventi di UI Automation che devono essere supportati da tutti i controlli pulsante. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di UI Automation | Supporto tecnico | Note |
|---|---|---|
| AutomationFocusChangedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàNameProperty . | Richiesto | None |
| StructureChangedEvent | Richiesto | None |
| InvokedEvent | Dipende da | Se il controllo supporta il pattern di controllo Invoke, deve supportare questo evento. |
| Evento di modifica della proprietàToggleStateProperty . | Dipende da | Se il controllo supporta il pattern di controllo Toggle, deve supportare questo evento. |