Suporte de Automação de Interface de Usuário para o Tipo de Controle ToolBar

Observação

Esta documentação destina.Os desenvolvedores do NET Framework que desejam usar o gerenciado UI Automation classes definidas na System.Windows.Automation namespace.As informações mais recentes sobre UI Automation, consulte API de automação do Windows: Automação da interface do usuário.

Este tópico fornece informações sobre UI Automation suporte para a barra de ferramentas o tipo de controle. In UI Automation, a control type is a set of conditions that a control must meet in order to use the ControlTypeProperty property. As condições incluem as diretrizes específicas para UI Automation estrutura de árvore, UI Automation os valores de propriedade e padrões de controle. Controles da barra de ferramenta permitem que os usuários finais ativar os comandos e ferramentas contidas dentro de um aplicativo.

The following sections define the required UI Automation tree structure, properties, control patterns, and events for the ToolBar control type. The UI Automation requirements apply to all tool bar controls, whether Windows Presentation Foundation (WPF), Win32, or Windows Forms.

Este tópico contém as seguintes seções.

• Required UI Automation Tree Structure
• Required UI Automation Properties
• Required UI Automation Control Patterns
• Required UI Automation Events
• Tópicos relacionados

Required UI Automation Tree Structure

The following table depicts the control view and the content view of the UI Automation tree that pertains to tool bar controls and describes what can be contained in each view. For more information on the UI Automation tree, see Visão geral da árvore de automação de interface do usuário.

Control View	Content View
ToolBar Various controls (0 or more)	ToolBar Various controls (0 or more)

A tool bar control can contain any type of control within its subtree. They most often contain buttons, combo boxes, and split buttons.

Required UI Automation Properties

The following table lists the UI Automation properties whose value or definition is especially relevant to tool bar controls. For more information on UI Automation properties, see UI Automation Properties for Clients.

UI Automation Property	Value	Notes
AutomationIdProperty	See notes.	The value of this property needs to be unique across all controls in an application.
BoundingRectangleProperty	See notes.	The outermost rectangle that contains the whole control.
ClickablePointProperty	See notes.	Supported if there is a bounding rectangle. If not every point within the bounding rectangle is clickable, and you perform specialized hit testing, then override and provide a clickable point.
IsKeyboardFocusableProperty	See notes.	If the control can receive keyboard focus, it must support this property.
NameProperty	Depends	The tool bar control does not need a name unless more than one is used within an application. If more than one is present, each must have a distinguishing name (for example, Formatting or Outlining).
LabeledByProperty	Null	Tool bar controls never have a label.
ControlTypeProperty	ToolBar	This value is the same for all UI frameworks.
LocalizedControlTypeProperty	"tool bar"	Localized string corresponding to the ToolBar control type.
IsContentElementProperty	True	The tool bar control is always content.
IsControlElementProperty	True	The tool bar control must always be a control.

Required UI Automation Control Patterns

The following table lists the UI Automation control patterns required to be supported by tool bar controls. For more information on control patterns, see Visão Geral de Padrões de Controle de Automação de Interface de Usuário.

Padrão de controle	Support	Notes
ExpandCollapsePattern	Depends	If the tool bar can be expanded and collapsed to show more items, then it must support this pattern.
DockPattern	Depends	If the tool bar can be docked to different parts of the screen, then it must support this pattern.
TransformPattern	Depends	If the tool bar can be resized, rotated, or moved, it must support this pattern.

Required UI Automation Events

The following table lists the UI Automation events required to be supported by all tool bar controls. For more information on events, see Visão geral sobre eventos de automação de interface do usuário.

UI Automation Event	Support	Notes
BoundingRectangleProperty property-changed event.	Required	None
IsOffscreenProperty property-changed event.	Required	None
IsEnabledProperty property-changed event.	Required	None
ExpandCollapseStateProperty property-changed event.	Depends	None
AutomationFocusChangedEvent	Required	None
StructureChangedEvent	Required	None

Consulte também

Referência

ToolBar

Conceitos

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

UI Automation Overview