Tipo di controllo Pulsante

  • Articolo

In questo argomento vengono fornite informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo Button.

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 sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo Button. I requisiti Automazione interfaccia utente si applicano a tutti i controlli dei pulsanti in cui il framework o la piattaforma dell'interfaccia utente si integra Automazione interfaccia utente supporto per i tipi di controllo e i pattern di controllo.

In questo argomento sono contenute le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero Automazione interfaccia utente relativo ai controlli pulsante e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.

Visualizzazione controlli Visualizzazione contenuto
  • Pulsante
    • Image (0 o più)
    • Text (0 o più)
  • Pulsante

 

Proprietà pertinenti

Nella tabella seguente sono elencate le proprietà 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 Recupero di proprietà da elementi Automazione interfaccia utente.

Proprietà di automazione interfaccia utente Valore Note
UIA_AcceleratorKeyPropertyId Vedere le note. Un controllo pulsante supporta in genere un tasto di scelta rapida per consentire all'utente finale di eseguire rapidamente l'azione rappresentata dal pulsante dalla tastiera.
UIA_AutomationIdPropertyId Vedere le note. Il valore di questa proprietà deve essere univoco tra tutti gli elementi peer nella visualizzazione non elaborata dell'albero Automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Il rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue hit testing specializzati, esegue l'override e fornisce un punto selezionabile.
UIA_ControlTypePropertyId Button
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida deve indicare quale sarà il risultato finale dell'attivazione del pulsante. Si tratta in genere dello stesso tipo di informazioni presentate tramite una descrizione comando.
UIA_IsContentElementPropertyId TRUE Il controllo pulsante deve essere sempre contenuto.
UIA_IsControlElementPropertyId TRUE Il controllo pulsante deve essere sempre un controllo .
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.
UIA_LabeledByPropertyId Null Ai controlli Button viene automaticamente applicata un'etichetta in base al relativo contenuto.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo Button . Il valore predefinito è "button" per en-US o english (Stati Uniti).
UIA_NamePropertyId Vedere le note. Il nome del controllo pulsante è il testo usato per etichettarlo. Ogni volta che viene usata un'immagine per etichettare un pulsante, è necessario specificare testo alternativo per la proprietà Name del pulsante.

 

Pattern di controllo obbligatori

Nella tabella seguente sono elencati i pattern di controllo 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.

Pattern di controllo/proprietà del pattern Supporto/valore Note
IExpandCollapseProvider Vedere le note. Quando un pulsante è ospitato come elemento figlio di un pulsante di divisione, il pulsante figlio può supportare il pattern di controllo ExpandCollapse anziché il pattern di controllo Invoke o Toggle . Il pattern di controllo ExpandCollapse può essere utilizzato per aprire o chiudere un menu o un'altra sottostruttura associata all'elemento button.
IInvokeProvider Vedere le note. Tutti i pulsanti devono supportare il pattern di controllo Invoke o il pattern di controllo Attiva/ Disattiva, ma non entrambi. Il pattern di controllo Invoke deve essere 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 modello di controllo Invoke o il modello di controllo Attiva attivazione , ma non entrambi. Il modello di controllo Disattiva deve essere supportato se il pulsante può eseguire il ciclo attraverso una serie di fino a tre stati. In genere viene interpretato come opzione di attivazione/disattivazione per funzionalità specifiche.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che i controlli pulsante sono necessari per supportare. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.

Automazione interfaccia utente evento Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento modificato dalla proprietà.
UIA_Invoke_InvokedEventId Se il controllo supporta il modello di controllo Invoke , deve supportare questo evento.
UIA_IsEnabledPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento.
UIA_IsOffscreenPropertyId evento modificato dalla proprietà. Se il controllo supporta la proprietà IsOffscreen , deve supportare questo evento.
UIA_NamePropertyId evento modificato dalla proprietà.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId evento modificato dalla proprietà. Se il controllo supporta il modello di controllo Attiva attivazione, deve supportare questo evento.

 

Informazioni concettuali

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

Cenni preliminari su automazione interfaccia utente