Supporto per l'automazione interfaccia utente del tipo di controllo SplitButton
Nota
Questa documentazione è destinata agli sviluppatori .NET Framework che desiderano utilizzare le classi di Automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per informazioni aggiornate su Automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto per Automazione interfaccia utente per il tipo di controllo SplitButton. In Automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter 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 e i criteri di controllo.
Il controllo pulsante di menu combinato offre la possibilità di eseguire un'azione su un controllo ed espandere il controllo per visualizzare l'elenco delle altre azioni che possono essere eseguite.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i criteri di controllo e gli eventi di Automazione interfaccia utente necessari per il tipo di controllo SplitButton. I requisiti di Automazione interfaccia utente si applicano a tutti i controlli pulsante di menu combinato, siano essi Windows Presentation Foundation (WPF), Win32 o Windows Form.
Struttura ad albero di automazione interfaccia utente obbligatoria
La tabella seguente mostra la vista controllo e la vista contenuto dell'albero di Automazione interfaccia utente che riguarda i controlli pulsante di menu combinato e descrive cosa può essere contenuto in ogni vista. Per altre informazioni sull'albero di Automazione interfaccia utente, vedere Panoramica dell'albero di Automazione interfaccia utente.
| Visualizzazione controlli | Visualizzazione contenuto |
|---|---|
SplitButton
|
SplitButton - MenuItem (da 1 a molti) |
Proprietà di automazione interfaccia utente obbligatorie
La tabella seguente elenca le proprietà di Automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli pulsante di menu combinato. Per altre informazioni sulle proprietà di Automazione interfaccia utente, vedere Proprietà di Automazione interfaccia utente per i client.
| Proprietà di automazione interfaccia utente | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli in un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Il rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportata se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili ed è stato eseguito un processo di hit testing specializzato, eseguire l'override e implementare un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà. |
| NameProperty | "Indietro" | Il nome del controllo pulsante di menu combinato viene visualizzato sul pulsante. |
| LabeledByProperty | Null | I controlli pulsante di menu combinato non hanno un'etichetta di testo statico. |
| ControlTypeProperty | SplitButton | Questo valore è uguale per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "split button" | Stringa localizzata corrispondente al tipo di controllo SplitButton. |
| HelpTextProperty | 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. |
| IsContentElementProperty | Vero | Il controllo pulsante di menu combinato contiene informazioni per l'utente finale. |
| IsControlElementProperty | Vero | Il controllo pulsante di menu combinato è visibile all'utente finale. |
Pattern di controllo obbligatori per l'automazione interfaccia utente
La tabella seguente elenca i modelli di controllo di Automazione interfaccia utente che devono essere supportati dai controlli pulsante di menu combinato. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Supporto tecnico | Note |
|---|---|---|
| IInvokeProvider | Richiesto | I pulsanti di menu combinato presentano sempre un'azione predefinita associata a Invoke. |
| IExpandCollapseProvider | Richiesto | I pulsanti pulsante di menu combinato hanno sempre la possibilità di espandere un elenco di opzioni. |
Eventi di automazione interfaccia utente obbligatori
La tabella seguente elenca gli eventi di Automazione interfaccia utente che devono essere supportati da tutti i controlli pulsante di menu combinato. Per altre informazioni sugli eventi, vedere UI Automation Events Overview.
| Evento di Automazione interfaccia utente | Supporto tecnico | Note |
|---|---|---|
| InvokedEvent | Richiesto | None |
| Evento di modifica della proprietàBoundingRectangleProperty . | Richiesto | None |
| Evento di modifica della proprietàIsOffscreenProperty . | Richiesto | None |
| Evento di modifica della proprietàIsEnabledProperty . | Richiesto | None |
| Evento di modifica della proprietàExpandCollapseStateProperty . | Richiesto | None |
| AutomationFocusChangedEvent | Richiesto | None |
| StructureChangedEvent | Richiesto | None |
Esempio di controllo SplitButton
Nell'immagine seguente viene illustrato un tipo di controllo SplitButton in un controllo griglia dati.
La visualizzazione controlli e la visualizzazione di contenuto dell'albero di automazione interfaccia utente relativo ai controlli griglia dati e pulsante di comando combinato sono visualizzate di seguito. I pattern di controllo per ogni elemento di automazione sono indicati tra parentesi.
| Albero di Automazione interfaccia utente - Vista controllo | Albero di Automazione interfaccia utente - Vista contenuto |
|---|---|
|
|