Condividi tramite

Tipo di controllo pulsante

  • Articolo

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

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 Pulsante. I requisiti di automazione interfaccia utente si applicano a tutti i controlli pulsante in cui il framework o la piattaforma dell'interfaccia utente integra il supporto di Automazione interfaccia utente per i tipi di controllo e i pattern di controllo.

Questo argomento contiene le sezioni seguenti.

Struttura ad albero tipica

La tabella seguente illustra un controllo e una visualizzazione contenuto tipici dell'albero di automazione interfaccia utente che riguarda i controlli pulsante e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.

Visualizzazione controlli Visualizzazione contenuto
  • Bottone
    • Immagine (0 o più)
    • Testo (0 o più)
  • Bottone

 

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli che implementano il tipo di controllo pulsante (ad esempio i controlli pulsante). Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Recupero delle proprietà dagli elementi di automazione interfaccia utente.

Ui Automation, proprietà 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 di automazione interfaccia utente.
UIA_BoundingRectanglePropertyId Vedere le note. Rettangolo più esterno che contiene l'intero controllo.
UIA_ClickablePointPropertyId Vedere le note. Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e l'elemento esegue un hit testing specializzato, eseguire l'override e fornire un punto selezionabile.
UIA_ControlTypePropertyId pulsante
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida dovrebbe 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 VERO Il controllo pulsante deve essere sempre contenuto.
UIA_IsControlElementPropertyId VERO Il controllo pulsante deve essere sempre un controllo .
UIA_IsKeyboardFocusablePropertyId Vedere le note. Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà.
UIA_LabeledByPropertyId Nullo I controlli pulsante sono auto-etichettati in base al contenuto.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo button. Il valore predefinito è "button" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId 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 obbligatori

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/pattern, proprietà 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 Attiva/Disattiva. Il pattern di controllo ExpandCollapse può essere utilizzato per aprire o chiudere un menu o un'altra sottostruttura associata all'elemento pulsante.
IInvokeProvider Vedere le note. Tutti i pulsanti devono supportare il pattern di controllo invoke o l'interruttore , 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 pattern di controllo invoke o l'interruttore , ma non entrambi. Il pattern di controllo Attiva/Disattiva deve essere supportato se il pulsante può scorrere una serie di fino a tre stati. In genere si tratta di un interruttore attivato/disattivato per funzionalità specifiche.

 

Eventi obbligatori

La tabella seguente elenca gli eventi di automazione interfaccia utente necessari per supportare i controlli pulsante. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .

Evento di automazione interfaccia utente Note
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento di modifica delle proprietà.
UIA_Invoke_InvokedEventId Se il controllo supporta il pattern di controllo Invoke, deve supportare questo evento.
UIA_IsEnabledPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsEnabled, deve supportare questo evento.
UIA_IsOffscreenPropertyId evento di modifica delle proprietà. Se il controllo supporta la proprietàIsOffscreen, deve supportare questo evento.
UIA_NamePropertyId evento di modifica delle proprietà.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId evento di modifica delle proprietà. Se il controllo supporta il pattern di controllo Attiva/Disattiva, deve supportare questo evento.

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente