Supporto per automazione interfaccia utente del tipo di controllo Button

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto di automazione interfaccia utente per il tipo di controllo Button. In automazione interfaccia utente un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare al fine di 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, 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 solo comando che l'utente desidera eseguire.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo Button. I requisiti di automazione interfaccia utente si applicano a tutti i controlli pulsante, Windows Presentation Foundation (WPF), Win32 o Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente obbligatoria
  • Proprietà di automazione interfaccia utente obbligatorie
  • Pattern di controllo di automazione interfaccia utente obbligatori
  • Eventi di automazione interfaccia utente obbligatori
  • Argomenti correlati

Struttura ad albero di automazione interfaccia utente obbligatoria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relativamente ai controlli pulsante e viene descritto il contenuto di ogni visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli

Visualizzazione contenuto

  • Button

  • Image (0 o più)

  • Text (0 o più)

  • Button

Proprietà di automazione interfaccia utente obbligatorie

Nella tabella seguente sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo Button, ad esempio i controlli pulsante. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà di automazione interfaccia utente

Valore

Note

AcceleratorKeyProperty

Vedere le note.

Il controllo pulsante deve in genere supportare un tasto di scelta rapida per consentire a un utente finale di eseguire dalla tastiera l'azione rappresentata dal pulsante.

AutomationIdProperty()

Vedere le note.

Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.

BoundingRectangleProperty

Vedere le note.

Rettangolo più esterno che contiene l'intero controllo.

ClickablePointProperty

Vedere le note.

Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.

ControlTypeProperty

Button

Questo valore è identico per tutti i framework dell'interfaccia utente.

HelpTextProperty

Vedere le note.

Il testo della Guida dovrebbe indicare il risultato finale dell'attivazione del pulsante. Queste informazioni devono essere esposte tramite una descrizione comandi.

IsContentElementProperty

True

Il controllo pulsante deve essere sempre un contenuto.

IsControlElementProperty

True

Il controllo pulsante 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 pulsanti sono controlli con etichetta automatica in base al relativo contenuto.

LocalizedControlTypeProperty

"pulsante"

Stringa localizzata che corrisponde al tipo di controllo Button.

NameProperty

Vedere le note.

Il nome del controllo pulsante è il testo utilizzato per etichettarlo. Ogni volta che si utilizza un'immagine per etichettare un pulsante, è necessario fornire testo alternativo per la proprietà Name del pulsante.

Pattern di controllo di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che devono essere supportati da tutti i controlli Button. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/Proprietà pattern

Supporto/Valore

Note

IInvokeProvider

Vedere le note.

Tutti i pulsanti devono supportare il pattern di controllo Invoke o Toggle. Invoke è supportato quando il pulsante esegue un comando su richiesta dell'utente. Questo comando esegue il mapping a una sola operazione, ad esempio Taglia, Copia, Incolla o Elimina.

IToggleProvider

Vedere le note.

Tutti i pulsanti devono supportare il pattern di controllo Invoke o Toggle. Toggle è supportato se per il pulsante è possibile alternare una serie di al massimo tre stati. Si tratta in genere di un pulsante attivato/disattivato per funzionalità specifiche.

Eventi di automazione interfaccia utente obbligatori

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli pulsante. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento di automazione interfaccia utente

Supporto

Note

AutomationFocusChangedEvent

Obbligatorio

Nessuno

Evento di proprietà modificata BoundingRectangleProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsOffscreenProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata IsEnabledProperty.

Obbligatorio

Nessuno

Evento di proprietà modificata NameProperty.

Obbligatorio

Nessuno

StructureChangedEvent

Obbligatorio

Nessuno

InvokedEvent

A seconda dei casi

Se il controllo supporta il pattern di controllo Invoke, deve supportare questo evento.

Evento di proprietà modificata ToggleStateProperty.

A seconda dei casi

Se il controllo supporta il pattern di controllo Toggle, deve supportare questo evento.

Vedere anche

Concetti

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente

Riferimenti

Button