Suporte a Automação de IU para o Tipo de Controle CheckBox

Artigo
08/01/2011

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 Microsoft UI Automation suporte para a caixa de seleção o tipo de controle. Em UI Automation, um tipo de controle é um conjunto de condições que um controle deve atender para usar o ControlTypeProperty propriedade. 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.

A check box is an object used to indicate a state that users can interact with to cycle through that state. Check boxes either present a binary (Yes/No), (On/Off), or tertiary (On, Off, Indeterminate) option to the user.

The following sections define the required UI Automation tree structure, properties, control patterns, and events for the CheckBox control type. The UI Automation requirements apply to all check box 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 Control Patterns
Required UI Automation Events
Default Action
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 check box 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
CheckBox	CheckBox

Observação

Check boxes never have child elements in the control or content view.If the control does need to contain child elements this indicates that another control type should be used.

Required UI Automation Properties

A tabela a seguir listas os UI Automation propriedades cujo valor ou a definição são especialmente relevantes para controles de caixa de seleção. Para obter mais informações sobre UI Automation Propriedades, consulte 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.
ControlTypeProperty	CheckBox	This value is the same for all UI frameworks.
IsContentElementProperty	True	The value of this property must always be True. This means that the check box control must always be included in the content view of the UI Automation tree.
IsControlElementProperty	True	The value of this property must always be True. This means that the check box control must always be included in the control view of the UI Automation tree.
IsKeyboardFocusableProperty	See notes.	If the control can receive keyboard focus, it must support this property.
LabeledByProperty	Null	Check boxes are self-labeling controls.
LocalizedControlTypeProperty	"check box"	Localized string corresponding to the CheckBox control type.
NameProperty	See notes.	The value of the check box control's Name property is the text that is displayed beside the box that maintains the toggle state.

Required UI Automation Control Patterns

The following table lists the UI Automation control patterns required to be supported by all check box controls. Para obter mais informações sobre padrão do controles, consulte Visão Geral de Padrões de Controle de Automação de Interface de Usuário.

Padrão de controle	Support	Notes
IToggleProvider	Required	Allows the check box to be cycled through its internal states programmatically.

Required UI Automation Events

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

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

Default Action

The default action of the check box is to cause a radio button to become focused and toggle its current state. As mentioned previously, check boxes either present a binary (Yes/No) (On/Off) decision to the user or a tertiary (On, Off, Indeterminate). If the check box is binary the default action causes the "on" state to become "off" or the "off" state to become "on". In a tertiary state check box the default action cycles through the states of the check box in the same order as if the user had sent successive mouse clicks to the control.