Supporto per l'automazione interfaccia utente del tipo di controllo ToolBar

Aggiornamento: novembre 2007

In questo argomento vengono fornite informazioni sul supporto per automazione interfaccia utente del tipo di controllo ToolBar. In automazione interfaccia utente, un tipo di controllo è un insieme di condizioni che un controllo deve soddisfare per poter utilizzare la proprietà ControlTypeProperty. Tali condizioni includono linee guida specifiche per la struttura ad albero di automazione interfaccia utente, i valori di proprietà di automazione interfaccia utente e i pattern di controllo. I controlli della barra degli strumenti consentono agli utenti finali di attivare i comandi e gli strumenti di un'applicazione.

Nelle sezioni seguenti vengono definiti la struttura ad albero, le proprietà, i pattern di controllo e gli eventi di automazione interfaccia utente necessari per il tipo di controllo ToolBar. I requisiti di automazione interfaccia utente si applicano a tutti i controlli ToolBar, Windows Presentation Foundation (WPF), Win32 o Windows Form.

Nel presente argomento sono contenute le seguenti sezioni.

  • Struttura ad albero di automazione interfaccia utente necessaria
  • Proprietà di automazione interfaccia utente necessarie
  • Pattern di controllo di automazione interfaccia utente necessari
  • Eventi di automazione interfaccia utente necessari
  • Argomenti correlati

Struttura ad albero di automazione interfaccia utente necessaria

Nella tabella riportata di seguito vengono illustrate la visualizzazione controlli e la visualizzazione contenuto della struttura ad albero di automazione interfaccia utente relative ai controlli della barra degli strumenti e viene descritto il contenuto consentito per ciascuna visualizzazione. Per ulteriori informazioni sulla struttura ad albero di automazione interfaccia utente, vedere Cenni preliminari sulla struttura di automazione dell'interfaccia utente.

Visualizzazione controlli

Visualizzazione contenuto

  • ToolBar

  • Vari controlli (0 o più)

  • ToolBar

  • Vari controlli (0 o più)

Un controllo ToolBar può contenere qualsiasi tipi di controllo del relativo sottoalbero. Nella maggior parte dei casi, contiene pulsanti, caselle combinate e pulsanti dividi.

Proprietà di automazione interfaccia utente necessarie

Nella tabella riportata di seguito sono elencate le proprietà di automazione interfaccia utente il cui valore o la cui definizione è particolarmente rilevante per i controlli ToolBar. Per ulteriori informazioni sulle proprietà di automazione interfaccia utente, vedere Proprietà di automazione interfaccia utente per i client.

Proprietà automazione interfaccia utente

Value

Note

AutomationIdProperty()

Vedere le note.

Il valore di questa proprietà deve essere univoco per tutti i controlli di un'applicazione.

BoundingRectangleProperty

Vedere le note.

Il rettangolo più esterno che contiene l'intero controllo.

ClickablePointProperty

Vedere le note.

Supportata se esiste un rettangolo di delimitazione. Se non è possibile fare clic su ogni punto all'interno del rettangolo di delimitazione e vengono eseguiti hit test speciali, eseguire l'override e fornire un punto selezionabile.

IsKeyboardFocusableProperty

Vedere le note.

Se il controllo può ricevere lo stato attivo, deve supportare questa proprietà.

NameProperty

A seconda dei casi

Il controllo ToolBar non necessita di un nome a meno che non ne venga utilizzato più di uno all'interno di un'applicazione. Se sono presenti più controlli, ciascuno di loro deve avere un nome distinto (ad esempio, Formatting o Outlining).

LabeledByProperty

Null

I controlli ToolBar non includono mai un'etichetta.

ControlTypeProperty

ToolBar

Questo valore è identico per tutti i framework dell'interfaccia utente.

LocalizedControlTypeProperty

"tool bar"

Stringa localizzata che corrisponde al tipo di controllo ToolBar.

IsContentElementProperty

True

Il controllo ToolBar è sempre un contenuto.

IsControlElementProperty

True

Il controllo ToolBar deve essere sempre un controllo.

Pattern di controllo di automazione interfaccia utente necessari

Nella tabella riportata di seguito sono elencati i pattern di controllo di automazione interfaccia utente che i controlli ToolBar dovranno supportare. Per ulteriori informazioni sui pattern di controllo, vedere Cenni preliminari sui pattern di controllo per l'automazione interfaccia utente.

Pattern di controllo/proprietà pattern

Supporto/valore

Note

ExpandCollapsePattern

A seconda dei casi

Se la barra degli strumenti può essere espansa e compressa per visualizzare più elementi, deve supportare questo pattern.

DockPattern

A seconda dei casi

Se la barra degli strumenti può essere ancorata a diverse parti dello schermo, deve supportare questo pattern.

TransformPattern

A seconda dei casi

Se la barra degli strumenti può essere ridimensionata, ruotata o spostata, deve supportare questo pattern.

Eventi di automazione interfaccia utente necessari

Nella tabella riportata di seguito sono elencati gli eventi di automazione interfaccia utente che devono essere supportati da tutti i controlli della barra degli strumenti. Per ulteriori informazioni sugli eventi, vedere Cenni preliminari sugli eventi di automazione interfaccia utente.

Evento automazione interfaccia utente

Supporto

Note

Evento di modifica della proprietà BoundingRectangleProperty.

Richiesto

Nessuno

Evento di proprietà modificata IsOffscreenProperty.

Richiesto

Nessuno

Evento di proprietà modificata IsEnabledProperty.

Richiesto

Nessuno

Evento di proprietà modificata ExpandCollapseStateProperty.

A seconda dei casi

Nessuno

AutomationFocusChangedEvent

Richiesto

Nessuno

StructureChangedEvent

Richiesto

Nessuno

Vedere anche

Concetti

Cenni preliminari sui tipi di controllo per l'automazione interfaccia utente

Cenni preliminari su automazione interfaccia utente

Riferimenti

ToolBar