Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Annotazioni
Questa documentazione è destinata agli sviluppatori .NET Framework che vogliono usare le classi di automazione interfaccia utente gestite definite nello spazio dei nomi System.Windows.Automation. Per le informazioni più recenti sull'automazione interfaccia utente, vedere API di automazione di Windows: Automazione interfaccia utente.
Questo argomento fornisce informazioni sul supporto dell'automazione interfaccia utente per il tipo di controllo SplitButton. In Automazione interfaccia utente un tipo di controllo è un set di condizioni che un controllo deve soddisfare per usare la ControlTypeProperty proprietà . 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 pattern di controllo.
Il controllo pulsante di divisione consente di eseguire un'azione su un controllo ed espandere il controllo per visualizzare un elenco di altre azioni possibili che possono essere eseguite.
Le sezioni seguenti definiscono la struttura ad albero, le proprietà, i pattern di controllo e gli eventi necessari per il tipo di controllo SplitButton. I requisiti di automazione dell'interfaccia utente si applicano a tutti i controlli pulsanti divisi, sia che siano Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Struttura ad albero necessaria per l'automazione UI
La tabella seguente illustra la visualizzazione dei controlli e la visualizzazione dei contenuti dell'albero dell'automazione dell'interfaccia utente relativi ai controlli del pulsante di divisione e descrive cosa può essere contenuto in ciascuna visualizzazione. Per altre informazioni sull'albero di automazione interfaccia utente, vedere ui Automation Tree Overview.
| Vista di controllo | Visualizzazione contenuto |
|---|---|
SplitButton
|
SplitButton - MenuItem (da 1 a molti) |
Proprietà di automazione interfaccia utente necessarie
La tabella seguente elenca le proprietà di automazione interfaccia utente il cui valore o definizione è particolarmente rilevante per i controlli pulsante di divisione. Per altre informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.
| Ui Automation, proprietà | Valore | Note |
|---|---|---|
| AutomationIdProperty | Vedere le note. | Il valore di questa proprietà deve essere univoco in tutti i controlli di un'applicazione. |
| BoundingRectangleProperty | Vedere le note. | Rettangolo più esterno che contiene l'intero controllo. |
| ClickablePointProperty | Vedere le note. | Supportato se è presente un rettangolo di delimitazione. Se non tutti i punti all'interno del rettangolo di delimitazione sono selezionabili e si eseguono hit testing specializzati, eseguire l'override e fornire un punto selezionabile. |
| IsKeyboardFocusableProperty | Vedere le note. | Se il controllo può ricevere lo stato attivo della tastiera, deve supportare questa proprietà. |
| NameProperty | "Indietro" | Il nome del controllo del pulsante diviso viene visualizzato sul pulsante. |
| LabeledByProperty | Nullo | I controlli pulsante di divisione non hanno un'etichetta di testo statica. |
| ControlTypeProperty | SplitButton | Questo valore è lo stesso per tutti i framework dell'interfaccia utente. |
| LocalizedControlTypeProperty | "pulsante di divisione" | 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 divisione, che in genere corrisponde allo stesso tipo di informazioni presentate tramite una descrizione comando. |
| IsContentElementProperty | Vero | Il controllo pulsante di divisione contiene informazioni per l'utente finale. |
| IsControlElementProperty | Vero | Il controllo pulsante di divisione è visibile all'utente finale. |
Modelli di controllo di automazione interfaccia utente necessari
La tabella seguente elenca i modelli di controllo di automazione interfaccia utente necessari per essere supportati dai controlli pulsante di divisione. Per altre informazioni sui pattern di controllo, vedere UI Automation Control Patterns Overview.
| Pattern di controllo | Assistenza | Note |
|---|---|---|
| IInvokeProvider | Obbligatorio | I pulsanti di divisione hanno sempre un'azione predefinita associata a Invoke. |
| IExpandCollapseProvider | Obbligatorio | I pulsanti di divisione hanno sempre la possibilità di espandere un elenco di opzioni. |
Eventi di automazione interfaccia utente necessari
Nella tabella seguente sono elencati gli eventi di Automazione UI richiesti per essere supportati da tutti i controlli pulsanti suddivisi. Per altre informazioni sugli eventi, vedere Panoramica degli eventi di automazione interfaccia utente .
| Evento di automazione interfaccia utente | Assistenza | Note |
|---|---|---|
| InvokedEvent | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà BoundingRectangleProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsOffscreenProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà IsEnabledProperty. | Obbligatorio | Nessuno |
| Evento di cambiamento della proprietà ExpandCollapseStateProperty. | Obbligatorio | Nessuno |
| AutomationFocusChangedEvent | Obbligatorio | Nessuno |
| StructureChangedEvent | Obbligatorio | Nessuno |
Esempio di controllo SplitButton
L'immagine seguente illustra un controllo di tipo SplitButton in una griglia dati.
La Visualizzazione del Controllo e la Visualizzazione del Contenuto dell'albero di automazione dell'interfaccia utente relativa alla griglia dei dati e ai controlli del pulsante di divisione sono mostrati di seguito. I pattern di controllo per ogni elemento di automazione vengono visualizzati tra parentesi.
| Albero di automazione interfaccia utente - Visualizzazione controllo | Albero di automazione interfaccia utente - Visualizzazione contenuto |
|---|---|
|
|