Compartilhar via

Suporte de automação de interface de usuário para o tipo de controle de calendário

  • Artigo

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 o calendário do 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 valores de propriedade, os padrões de controle, e UI Automation eventos.

Calendar controls allow a user to easily determine the date and select other dates.

The following sections define the required UI Automation tree structure, properties, control patterns, and events for the Calendar control type. The UI Automation requirements apply to all calendar 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 calendar 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

Calendar

  • DataGrid

    • Header (0 or 1)

    • HeaderItem (0 ou 7; quantidade depende de quantos dias são exibidos em colunas)

    • ListItem (quantity depends on how many days are displayed)

    • Botão (0 ou 2; para o modo de exibição de calendário de paginação)

Calendar

  • ListItem (quantity depends on how many days are displayed)

Calendar controls can be represented in many different forms within the user interface. The only guaranteed controls to be in the control view of the UI Automation tree are the data grid, header, header item, and list item controls.

Required UI Automation Properties

The following table lists the UI Automation properties whose value or definition is especially relevant to the calendar 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.

ControlTypeProperty

Calendar

This value is the same for all UI frameworks.

IsContentElementProperty

True

The calendar control is always included in the content view of the UI Automation tree.

IsControlElementProperty

True

The calendar control is always 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

See notes.

O rótulo do controle de documento. Typically, the title of the document is used.

LocalizedControlTypeProperty

"calendar"

Localized string corresponding to the Calendar control type.

NameProperty

See notes.

The calendar control typically gets its name from the current day’s date.

Required UI Automation Control Patterns

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

Control Pattern/Pattern Property

Support

Notes

IGridProvider

Yes

The calendar control always supports the Grid pattern because the days within a month are items that can be navigated spatially.

IScrollProvider

Depends

A maioria dos controles de calendário suportam invertendo o modo de exibição por página. O padrão de rolagem é recomendado para oferecer suporte a navegação de paginação.

ISelectionProvider

Depends

A maioria dos controles de calendário mantêm um determinado dia, mês ou ano como uma seleção do sub-elemento. Alguns calendários são selecionável de multi e outros só único selecionável.

ITableProvider

Yes

The calendar control always has a header within its subtree for the days of the week, so the Table pattern must be supported.

IValueProvider

No

O padrão de controle de valor não é necessário para os controles de calendário, porque você não pode definir o valor diretamente no controle. Se uma data específica é associada com o controle, as informações devem ser fornecidas pelo padrão de controle de seleção.

Required UI Automation Events

The following table lists the UI Automation events required to be supported by all calendar 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

IsEnabledProperty property-changed event.

Required

None

IsOffscreenProperty property-changed event.

Required

None

LayoutInvalidatedEvent

Required

None

StructureChangedEvent

Required

None

CurrentViewProperty property-changed event.

Depends

None

HorizontallyScrollableProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

HorizontalScrollPercentProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

HorizontalViewSizeProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

VerticalScrollPercentProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

VerticallyScrollableProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

VerticalViewSizeProperty property-changed event.

Depends

If the control supports the Scroll control pattern, it must support this event.

InvalidatedEvent

Required

None

Consulte também

Referência

Calendar

Conceitos

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

UI Automation Overview