Tipo di controllo SplitButton
Questo argomento fornisce informazioni sul supporto di Microsoft Automazione interfaccia utente per il tipo di controllo SplitButton.
Il controllo del pulsante di divisione consente di eseguire un'azione su un controllo e di espandere il controllo per visualizzare un elenco di altre azioni possibili che possono essere eseguite.
Le sezioni seguenti definiscono la struttura ad albero Automazione interfaccia utente, le proprietà, i modelli 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 dell'interfaccia utente/piattaforma integra Automazione interfaccia utente supporto per i tipi di controllo e i modelli di controllo.
In questo argomento sono contenute le sezioni seguenti.
- Struttura ad albero tipica
- Proprietà pertinenti
- Modelli di controllo obbligatori
- Eventi obbligatori
- Esempio di tipo di controllo SplitButton
- Argomenti correlati
Struttura ad albero tipica
Nella tabella seguente viene illustrata una visualizzazione tipica del controllo e del contenuto dell'albero Automazione interfaccia utente che riguarda i controlli pulsante di divisione e descrive cosa può essere contenuto in ogni visualizzazione. Per altre informazioni sull'albero Automazione interfaccia utente, vedere Panoramica dell'albero Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
|
|
Proprietà pertinenti
Nella tabella seguente sono elencate le proprietà Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per il tipo di controllo SplitButton. Per altre informazioni sulle proprietà Automazione interfaccia utente, vedere Recupero delle proprietà da elementi Automazione interfaccia utente.
| Proprietà di automazione interfaccia utente | 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 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 ogni punto all'interno del rettangolo di selezione è selezionabile e l'elemento esegue test di hit test specializzati, override e fornisce un punto clickable. |
| UIA_ControlTypePropertyId | SplitButton | Questo valore è uguale 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 menu combinato, che in genere è lo stesso tipo di informazioni visualizzate mediante una descrizione comando. |
| UIA_IsContentElementPropertyId | TRUE | Il controllo pulsante di menu combinato contiene informazioni per l'utente finale. |
| UIA_IsControlElementPropertyId | TRUE | Il controllo pulsante di menu combinato è visibile all'utente finale. |
| UIA_IsKeyboardFocusablePropertyId | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| UIA_LabeledByPropertyId | NULL | I controlli pulsante di menu combinato non hanno un'etichetta di testo statico. |
| 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 usato per etichettare il pulsante di divisione. Ogni volta che viene usata un'immagine per etichettare un pulsante di divisione, è necessario specificare testo alternativo per la proprietà Name del pulsante di divisione. |
Modelli di controllo obbligatori
Nella tabella seguente sono elencati i modelli di controllo 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.
| Pattern di controllo | Supporto | Note |
|---|---|---|
| IExpandCollapseProvider | Necessario | Poiché i pulsanti di divisione hanno sempre la possibilità di espandere un elenco di opzioni, devono supportare il modello di controllo ExpandCollapse . |
| IInvokeProvider | Necessario | Poiché i pulsanti di divisione hanno sempre un'azione predefinita associata al metodo IInvokeProvider::Invoke , devono supportare il modello di controllo Invoke . |
Eventi obbligatori
Nella tabella seguente sono elencati gli eventi Automazione interfaccia utente che suddivideno i controlli pulsante per supportare. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| evento Automazione interfaccia utente | Note |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento di modifica della proprietà. | |
| UIA_ExpandCollapseExpandCollapseStatePropertyId evento di modifica della proprietà. | |
| UIA_Invoke_InvokedEventId | |
| UIA_IsEnabledPropertyId evento di modifica della proprietà. | Se il controllo supporta la proprietà IsEnabled , deve supportare questo evento. |
| UIA_IsOffscreenPropertyId evento di modifica della 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 .
| albero Automazione interfaccia utente- Visualizzazione controllo | albero Automazione interfaccia utente: visualizzazione contenuto |
|---|---|
|
|
Argomenti correlati
-
Informazioni concettuali
-
Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente