Partilhar via

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

Observação

Esta documentação destina-se a desenvolvedores do .NET Framework que desejam usar as classes de automação da interface do usuário gerenciadas definidas no namespace System.Windows.Automation. Para obter as informações mais recentes sobre a automação da interface de utilizador, consulte API de automação do Windows: Automação da Interface de Utilizador.

Este tópico fornece informações sobre o suporte à automação da interface do usuário para o tipo de controle Calendário. Na automação da interface do usuário, um tipo de controle é um conjunto de condições que um controle deve atender para usar a ControlTypeProperty propriedade. As condições incluem diretrizes específicas para a estrutura da árvore de Automação da Interface do Usuário, valores de propriedade da Automação da Interface do Usuário, padrões de controle e eventos de Automação da Interface do Usuário.

Os controles de calendário permitem que um usuário determine facilmente a data e selecione outras datas.

As seções a seguir definem a estrutura da árvore de Automação da Interface do Usuário, propriedades, padrões de controle e eventos necessários para o tipo de controle Calendário. Os requisitos de automação da interface do usuário se aplicam a todos os controles de calendário, seja Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Estrutura de árvore de automação da interface do usuário necessária

A tabela a seguir descreve a exibição de controle e a exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence aos controles de calendário e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de automação da interface do usuário, consulte Visão geral da árvore de automação da interface do usuário.

Vista de Controlo Visualização de conteúdo
Calendário

  • DataGrid

    • Cabeçalho (0 ou 1)
    • HeaderItem (0 ou 7; a quantidade depende de quantos dias são exibidos em colunas)
    • ListItem (a quantidade depende de quantos dias são exibidos)
    • Botão (0 ou 2; para visualização de calendário de paginação)
 Calendário

- ListItem (quantidade depende de quantos dias são exibidos)

Os controles de calendário podem ser representados de muitas formas diferentes na interface do usuário. Os únicos controles garantidos na exibição de controle da árvore de Automação da Interface do Usuário são a grade de dados, o cabeçalho, o item de cabeçalho e os controles de item de lista.

Propriedades de automação da interface do usuário necessárias

A tabela a seguir lista as propriedades de Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles de calendário. Para obter mais informações sobre as propriedades de automação da interface do usuário, consulte Propriedades de automação da interface do usuário para clientes.

Propriedade de automação da interface do usuário Valor Observações
AutomationIdProperty Ver notas. O valor dessa propriedade precisa ser exclusivo em todos os controles em um aplicativo.
BoundingRectangleProperty Ver notas. O retângulo mais externo que contém todo o controle.
ClickablePointProperty Ver notas. Suportado se houver um retângulo delimitador. Se nem todos os pontos dentro do retângulo delimitador forem clicáveis e você executar testes de acerto especializados, substitua e forneça um ponto clicável.
ControlTypeProperty Calendário Esse valor é o mesmo para todas as estruturas de interface do usuário.
IsContentElementProperty Verdade O controle de calendário é sempre incluído na exibição de conteúdo da árvore de automação da interface do usuário.
IsControlElementProperty Verdade O controle de calendário é sempre incluído na exibição de controle da árvore de automação da interface do usuário.
IsKeyboardFocusableProperty Ver notas. Se o controle pode receber foco do teclado, ele deve suportar essa propriedade.
LabeledByProperty Ver notas. O rótulo do controle de documento. Normalmente, o título do documento é usado.
LocalizedControlTypeProperty "Calendário" Cadeia de caracteres localizada correspondente ao tipo de controle Calendar.
NameProperty Ver notas. O controle de calendário normalmente recebe seu nome da data do dia atual.

Padrões de controle de automação da interface do usuário necessários

A tabela a seguir lista os padrões de controle de automação da interface do usuário necessários para serem suportados por todos os controles de calendário. Para obter mais informações sobre padrões de controle, consulte Visão geral padrões de controle de automação da interface do usuário.

Propriedade Control Pattern/Pattern Apoio Observações
IGridProvider Sim O controle de calendário sempre suporta o padrão Grid porque os dias dentro de um mês são itens que podem ser navegados espacialmente.
IScrollProvider Depende A maioria dos controles de calendário suporta inverter a exibição por página. O padrão de rolagem é recomendado para suportar a navegação entre páginas.
ISelectionProvider Depende A maioria dos controles de calendário retém um dia, mês ou ano específico como uma seleção do subelemento. Alguns calendários são multi-selecionáveis e outros apenas único-selecionáveis.
ITableProvider Sim O controle de calendário sempre tem um cabeçalho dentro de sua subárvore para os dias da semana, portanto, o padrão Tabela deve ser suportado.
IValueProvider Não O padrão de controle Value não é necessário para controles de calendário porque você não pode definir o valor diretamente no controle. Se uma data específica estiver associada ao controlo, a informação deve ser fornecida através do padrão de controlo de seleção.

Eventos de automação da interface do usuário necessários

A tabela a seguir lista os eventos de automação da interface do usuário necessários para serem suportados por todos os controles de calendário. Para obter mais informações sobre eventos, consulte Visão geral eventos de automação da interface do usuário.

Evento de automação da interface do usuário Apoio Observações
AutomationFocusChangedEvent Obrigatório Nenhum
BoundingRectangleProperty evento de alteração de propriedade. Obrigatório Nenhum
IsEnabledProperty evento de alteração de propriedade. Obrigatório Nenhum
IsOffscreenProperty evento de alteração de propriedade. Obrigatório Nenhum
LayoutInvalidatedEvent Obrigatório Nenhum
StructureChangedEvent Obrigatório Nenhum
CurrentViewProperty evento de alteração de propriedade. Depende Nenhum
HorizontallyScrollableProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
HorizontalScrollPercentProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
HorizontalViewSizeProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
VerticalScrollPercentProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
VerticallyScrollableProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
VerticalViewSizeProperty evento de alteração de propriedade. Depende Se o controle oferecer suporte ao padrão de controle Scroll, ele deverá oferecer suporte a esse evento.
InvalidatedEvent Obrigatório Nenhum

Ver também

  • Last updated on