Condividi tramite


Tipo di controllo SplitButton

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

Il controllo pulsante di divisione consente di eseguire un'azione su un controllo e di espandere il controllo per visualizzare un elenco di altre azioni che è possibile eseguire.

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 SplitButton. I requisiti di automazione interfaccia utente si applicano a tutti i controlli pulsante di divisione 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 di divisione 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
  • SplitButton
    • Immagine (0 o 1)
    • Testo (0 o 1)
    • Pulsante (1 o 2)
      • Menu (0 o 1; viene visualizzato come elemento figlio di un sotto-pulsante che supporta il modello ExpandCollapse)
        • MenuItem (da 1 a molti)
  • SplitButton
    • Pulsante (1 o 2)
      • MenuItem (da 1 a molti)

 

Proprietà pertinenti

La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo SplitButton. 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_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 splitbutton Questo valore è lo stesso per tutti i framework dell'interfaccia utente.
UIA_HelpTextPropertyId Vedere le note. Il testo della Guida può indicare il risultato dell'attivazione del pulsante di divisione, che in genere corrisponde allo stesso tipo di informazioni presentate tramite una descrizione comando.
UIA_IsContentElementPropertyId VERO Il controllo pulsante di divisione contiene informazioni per l'utente finale.
UIA_IsControlElementPropertyId VERO Il controllo pulsante di divisione è visibile all'utente finale.
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 di divisione non hanno un'etichetta di testo statica.
UIA_LocalizedControlTypePropertyId Vedere le note. Stringa localizzata corrispondente al tipo di controllo splitbutton. Il valore predefinito è "pulsante di divisione" per en-US o inglese (Stati Uniti).
UIA_NamePropertyId Vedere le note. Testo utilizzato per etichettare il pulsante di divisione. Ogni volta che un'immagine viene usata per etichettare un pulsante di divisione, è necessario specificare testo alternativo per la proprietà Name del pulsante di divisione.

 

Modelli di controllo obbligatori

La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati da tutti i controlli pulsante di divisione. 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 Appoggiare Note
IExpandCollapseProvider Obbligatorio Poiché i pulsanti di divisione hanno sempre la possibilità di espandere un elenco di opzioni, devono supportare il pattern di controllo ExpandCollapse.
IInvokeProvider Obbligatorio Poiché i pulsanti di divisione hanno sempre un'azione predefinita associata al metodo IInvokeProvider::Invoke, devono supportare il pattern di controllo Invoke.

 

Eventi obbligatori

Nella tabella seguente sono elencati gli eventi di automazione interfaccia utente necessari per supportare i controlli pulsante di divisione. 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_ExpandCollapseExpandCollapseStatePropertyId evento di modifica delle proprietà.
UIA_Invoke_InvokedEventId
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_StructureChangedEventId

 

Esempio di tipo di controllo SplitButton

L'immagine seguente illustra un controllo che implementa il tipo di controllo splitbutton.

schermata che mostra un esempio di controllo splitbutton

Albero di automazione interfaccia utente- Visualizzazione controllo Albero di automazione interfaccia utente- Visualizzazione contenuto
  • SplitButton "Name" (Invoke, ExpandCollapse)
    • Pulsante "Altro opzione" (Invoke)
      • Menù
        • MenuItem
        • ...
  • SplitButton "Name" (Invoke, ExpandCollapse)
    • Pulsante "Altro opzione" (Invoke)
      • Menù
        • MenuItem
        • ...

 

concettuale

panoramica dei tipi di controllo di automazione interfaccia utente

panoramica dell'automazione interfaccia utente