Contrôle Sélecteur de dates dans Power Apps

Contrôle que l’utilisateur peut sélectionner pour spécifier une date.

Description

Si vous ajoutez un contrôle Sélecteur de dates au lieu d’un contrôle Saisie de texte, vous vous assurez que l’utilisateur spécifie une date au format approprié.

Propriétés clés

DefaultDate : valeur initiale d’une commande de date sauf si l’utilisateur la modifie.

SelectedDate : date actuellement sélectionnée dans une commande de date. Cette date est représentée en heure locale.

Format : format texte dans lequel la commande présente la date qui est spécifiée par l’utilisateur. Vous pouvez définir cette propriété sur ShortDate (par défaut) ou sur LongDate pour mettre en forme les dates sur la base de la propriété Language de ce contrôle. Vous pouvez également définir cette propriété sur une expression telle que aaaa/mm/jj si vous souhaitez utiliser le même format, quelle que soit la langue. Par exemple :

• Le contrôle affiche 12/31/2017 si l’utilisateur clique ou appuie sur le dernier jour de 2017, la propriété Format est définie sur ShortDate, et la propriété Language sur en-us.
• Le contrôle affiche dimanche 31 decembre 2017 si l’utilisateur clique ou appuie sur le dernier jour de 2017, la propriété Format est définie sur LongDate, et la propriété Language sur fr-fr.

Language : détermine la langue utilisée pour formater les dates, notamment les noms de mois. Si cette propriété n’est pas spécifiée, le paramètre de l’appareil de l’utilisateur détermine la langue. Les valeurs prises en charge incluent "EN-us" et "FR".

Propriétés supplémentaires

AccessibleLabel  : Étiquette pour les lecteurs d’écran.

BorderColor  : couleur de bordure du contrôle.

BorderStyle  : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness  : épaisseur de bordure d’un contrôle.

Color  : couleur du texte dans un contrôle.

DateTimeZone : indique si la date doit être affichée en UTC ou l’heure Locale de l’utilisateur.

DisplayMode  : indique si le contrôle autorise l’entrée utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

DisabledBorderColor  : couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledColor  : couleur du texte d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledFill  : couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

EndYear : la dernière année sur laquelle l’utilisateur peut définir la valeur d’un contrôle Sélecteur de dates.

Fill  : couleur d’arrière-plan d’un contrôle.

FocusedBorderColor  : couleur de bordure d’un contrôle lorsque le contrôle est actif.

FocusedBorderThickness  : épaisseur de bordure d’un contrôle lorsque le contrôle est actif.

Font  : nom de la famille de polices dans laquelle le texte s’affiche.

FontWeight  : épaisseur du texte dans un contrôle : Gras, Semibold, Normal ou Plus claire.

Height  : distance entre le haut et le bas d’un contrôle.

IconFill : couleur de premier plan de l’icône du sélecteur de dates.

IconBackground : couleur d’arrière-plan de l’icône du sélecteur de dates.

InputTextPlaceholder : texte d’instruction qui apparaît si aucune date n’est entrée.

IsEditable – Indique si le texte du Sélecteur de dates peut être modifié. Si définie sur false, la date ne peut être modifiée qu’en utilisant le calendrier.

Italic  : indique si le texte d’un contrôle est en italique.

OnSelect – Actions à effectuer lorsque l’utilisateur appuie ou clique sur un contrôle.

OnChange  – Actions à effectuer quand l’utilisateur modifie la valeur d’un contrôle.

Différence entre OnChange et OnSelect : OnSelect et OnChange se déclenchent sur la même action d’utilisateur si le clic de l’utilisateur entraîne la modification. Dans ce cas, OnSelect se déclenche avant OnChange.

PaddingBottom  : distance entre le texte d’un contrôle et le bord inférieur de ce contrôle.

PaddingLeft  : distance entre le texte d’un contrôle et le bord gauche de celui-ci.

PaddingRight  : distance entre le texte d’un contrôle et le bord droit de celui-ci.

PaddingTop  : distance entre le texte d’un contrôle et le bord supérieur de ce contrôle.

Reset – Si le contrôle Sélecteur de dates doit être réinitialisé à la valeur de DefaultDate.

Size  : taille de police du texte qui apparaît sur un contrôle.

StartOfWeek : le jour de la semaine à afficher dans la première colonne du jour du champ du sélecteur de date.

StartYear : la première année sur laquelle l’utilisateur peut définir la valeur d’un contrôle Sélecteur de dates.

TabIndex  : ordre de navigation à l’aide du clavier par rapport à d’autres contrôles.

Visible  : indique si un contrôle est visible ou est masqué.

Width  : distance entre les côtés droit et gauche d’un contrôle.

X  : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou de l’écran à défaut de conteneur parent).

Y  : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou de l’écran à défaut de conteneur parent).

Fonctions connexes

Year( DateTimeValue )

Exemples

Sélecteur de dates de base

1. Ajoutez un contrôle Sélecteur de dates et nommez-le « Échéance ».

   Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?

2. Ajoutez un contrôle Étiquette et définissez sa propriété Texte sur la formule suivante :

    DateDiff(Today(), Deadline.SelectedDate) & " days to go!"
   

   Vous souhaitez davantage d’informations sur la fonction DateDiff ou d’autres fonctions ?

3. Appuyez sur F5, choisissez une date dans Deadline, puis sélectionnez OK.

   Le contrôle Étiquette affiche le nombre de jours entre aujourd’hui et la date que vous avez choisie.

4. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Réinitialiser le sélecteur de date à la date par défaut

1. Ajoutez un contrôle Sélecteur de dates et nommez-le « DateTimeReset ».

   Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?

2. Ajoutez un contrôle Bouton et définissez sa propriété OnChange sur la formule suivante :

   Reset(DateTimeReset)
   

3. Appuyez sur F5, choisissez une nouvelle date dans DateTimeReset, puis sélectionnez OK.

4. Appuyez sur le bouton. La date reviendra à la DefaultDate (Aujourd’hui).

5. Appuyez sur Échap pour revenir à l’espace de travail par défaut.

Instructions d’accessibilité

Contraste des couleurs

• La configuration requise du contraste des couleurs standard s’applique.

Prise en charge du lecteur d’écran

• AccessibleLabel doit être présent.
• Si IsEditable a la valeur true et que Format n’est pas ce que les utilisateurs attendent, ajoutez Étiquette pour expliquer les formats de date acceptés.

Prise en charge du clavier

• TabIndex doit être égal ou supérieur à zéro afin que les utilisateurs du clavier puissent y accéder.
• Les indicateurs de focus doivent être clairement visibles. Pour ce faire, utilisez FocusedBorderColor et FocusedBorderThickness.