Partager via


Prise en charge d'UI Automation pour le type de contrôle Calendar

RemarqueRemarque

Cette documentation s'adresse aux développeurs .NET Framework qui veulent utiliser les classes UI Automation managées définies dans l'espace de noms System.Windows.Automation.Pour obtenir les informations les plus récentes sur UI Automation, consultez API Windows Automation : UI Automation (page éventuellement en anglais).

Cette rubrique fournit des informations sur la prise en charge d'UI Automation pour le type de contrôle Calendar. Dans UI Automation, un type de contrôle est un ensemble de conditions qu'un contrôle doit respecter pour utiliser la propriété ControlTypeProperty. Les conditions incluent des indications spécifiques pour l'arborescence UI Automation, les valeurs de propriété UI Automation, les modèles de contrôle et les événements d'UI Automation.

Les contrôles Calendar permettent à un utilisateur de déterminer facilement la date et d'en sélectionner d'autres.

Les sections suivantes définissent l'arborescence UI Automation, les propriétés, les modèles de contrôle et les événements requis pour le type de contrôle Calendar. Les spécifications UI Automation s'appliquent à tous les contrôles calendar, qu'il s'agisse de Windows Presentation Foundation (WPF), Win32 ou Windows Forms.

Cette rubrique comprend les sections suivantes.

  • Arborescence UI Automation requise
  • Propriétés UI Automation requises
  • Modèles de contrôle UI Automation requis
  • Événements UI Automation requis
  • Rubriques connexes

Arborescence UI Automation requise

Le tableau suivant décrit l'affichage de contrôle et l'affichage du contenu de l'arborescence UI Automation concernant les contrôles calendar et décrit ce qui peut être inclus dans chaque vue. Pour plus d'informations sur l'arborescence UI Automation, consultez Vue d'ensemble de l'arborescence UI Automation.

Affichage de contrôle

Affichage du contenu

Calendar

  • DataGrid

    • En-tête (0 ou 1)

    • HeaderItem (0 ou 7 ; la quantité dépend du nombre de jours affichés dans les colonnes)

    • ListItem (la quantité dépend du nombre de jours affichés)

    • Bouton (0 ou 2 ; pour paginer l'affichage du calendrier)

Calendar

  • ListItem (la quantité dépend du nombre de jours affichés)

Les contrôles Calendar peuvent être représentés sous différentes formes dans l'interface utilisateur. Les seuls contrôles qui sont sûrs d'être dans l'affichage de contrôle de l'arborescence UI Automation sont les contrôles data grid, header, header item et list item.

Propriétés UI Automation requises

Le tableau suivant répertorie les propriétés UI Automation dont la valeur ou la définition est particulièrement pertinente pour les contrôles calendar. Pour plus d'informations sur les propriétés UI Automation, consultez Propriétés UI Automation pour les clients.

Propriété UI Automation

Valeur

Remarques

AutomationIdProperty

Consulter les remarques.

La valeur de cette propriété doit être unique dans tous les contrôles d'une application.

BoundingRectangleProperty

Consulter les remarques.

Le rectangle le plus éloigné qui contient l'ensemble du contrôle.

ClickablePointProperty

Consulter les remarques.

Prise en charge s'il existe un rectangle englobant. Si les points du rectangle englobant ne sont pas tous interactifs et que vous effectuez un test de positionnement spécialisé, vous devez substituer et fournir un point interactif.

ControlTypeProperty

Calendar

Cette valeur est la même pour toutes les infrastructures d'UI.

IsContentElementProperty

True

Le contrôle Calendar est toujours inclus dans l'affichage du contenu de l'arborescence UI Automation.

IsControlElementProperty

True

Le contrôle Calendar est toujours inclus dans l'affichage de contrôle de l'arborescence UI Automation.

IsKeyboardFocusableProperty

Consulter les remarques.

Si le contrôle peut recevoir le focus clavier, il doit prendre en charge cette propriété.

LabeledByProperty

Consulter les remarques.

Étiquette du contrôle de document. En général, on utilise le titre du document.

LocalizedControlTypeProperty

"calendar"

Chaîne localisée correspondant au type de contrôle Calendar.

NameProperty

Consulter les remarques.

Le nom du contrôle Calendar correspond en général à la date du jour.

Modèles de contrôle UI Automation requis

Le tableau suivant répertorie les modèles de contrôle UI Automation qui doivent être pris en charge par tous les contrôles calendar. Pour plus d'informations sur les modèles de contrôle, consultez Vue d'ensemble des modèles de contrôle UI Automation.

Modèle de contrôle / Propriété du modèle

Prise en charge

Remarques

IGridProvider

Oui

Le contrôle calendar prend toujours en charge le modèle Grid car les jours d'un mois sont des éléments qui peuvent être parcourus de manière spatiale.

IScrollProvider

Selon le cas

La plupart des contrôles Calendar prennent en charge le retournement de la vue par page. Le modèle Scroll est recommandé pour prendre en charge la navigation de pagination.

ISelectionProvider

Selon le cas

La plupart des contrôles Calendar conservent un jour, un mois ou une année spécifique en tant que sélection du sous-élément. Certains calendriers peuvent être sélectionnés plusieurs fois et d'autres ne peuvent être sélectionnés qu'une seule fois.

ITableProvider

Oui

Le contrôle calendar dispose toujours d'un en-tête dans son sous-arbre pour les jours de la semaine ; le modèle Table doit donc être pris en charge.

IValueProvider

Non

Le modèle de contrôle Value n'est pas nécessaire pour les contrôles Calendar car vous ne pouvez pas définir directement la valeur sur le contrôle. Si une date spécifique est associée au contrôle, les informations doivent être fournies par le modèle de contrôle Selection.

Événements UI Automation requis

Le tableau suivant répertorie les événements UI Automation qui doivent être pris en charge par tous les contrôles calendar. Pour plus d'informations sur les événements, consultez Vue d'ensemble des événements UI Automation.

Événement UI Automation

Prise en charge

Remarques

AutomationFocusChangedEvent

Obligatoire

Aucun

Événement de modification de propriété BoundingRectangleProperty.

Obligatoire

Aucun

Événement de modification de propriété IsEnabledProperty.

Obligatoire

Aucun

Événement de modification de propriété IsOffscreenProperty.

Obligatoire

Aucun

LayoutInvalidatedEvent

Obligatoire

Aucun

StructureChangedEvent

Obligatoire

Aucun

Événement de modification de propriété CurrentViewProperty.

Selon le cas

Aucun

Événement de modification de propriété HorizontallyScrollableProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

Événement de modification de propriété HorizontalScrollPercentProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

Événement de modification de propriété HorizontalViewSizeProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

Événement de modification de propriété VerticalScrollPercentProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

Événement de modification de propriété VerticallyScrollableProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

Événement de modification de propriété VerticalViewSizeProperty.

Selon le cas

Si le contrôle prend en charge le modèle de contrôle de défilement, il doit prendre en charge cet événement.

InvalidatedEvent

Obligatoire

Aucun

Voir aussi

Référence

Calendar

Concepts

Vue d'ensemble des types de contrôle UI Automation

Vue d'ensemble d'UI Automation