DateField  - AS3 Flex

La propriété data vous permet de transmettre une valeur au composant lorsque vous l’utilisez dans un rendu d’élément ou un éditeur d’élément. Vous utilisez généralement la liaison des données pour lier un champ de la propriété data à une propriété de ce composant.

Lorsque vous utilisez le contrôle comme rendu d’élément supplémentaire ou éditeur d’élément supplémentaire, Flex écrit automatiquement la valeur actuelle de l’élément dans la propriété selectedDate de ce contrôle.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataChange .

Eléments de l’API associés

Nom des jours de la semaine du contrôle DateChooser. La définition de cette propriété change l’étiquette des jours du contrôle DateChooser. Dimanche est le premier jour (à l’index 0). Le reste des noms de la semaine suivent l’ordre normal.

La valeur par défaut est [ "S", "M", "T", "W", "T", "F", "S" ].

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dayNamesChanged .

Jours à désactiver dans une semaine. Toutes les dates du mois correspondant au jour spécifié sont désactivées. Cette propriété change l’interface utilisateur du contrôle DateChooser. Les éléments de ce tableau peuvent avoir des valeurs comprises entre 0 (dimanche) et 6 (samedi). Par exemple, la valeur [0, 6] affiche le dimanche et le samedi.

La valeur par défaut est [].

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement disabledDaysChanged .

Désactive un seul et plusieurs jours.

Cette propriété accepte un tableau d’objets en tant que paramètre. Chaque objet de ce tableau est un objet Date spécifiant un seul jour à désactiver, ou un objet contenant une des propriétés rangeStart et rangeEnd, voire les deux, dont les valeurs sont un objet Date. La valeur de ces propriétés décrit les limites de la période. Si l’une ou l’autre des propriétés est omise, la période est considérée comme illimitée dans le sens correspondant. Si vous ne spécifiez que la propriété rangeStart, toutes les dates qui se trouvent après la date spécifiée sont désactivées, y compris la date rangeStart. Si vous spécifiez uniquement la propriété rangeEnd, toutes les dates antérieures à la date spécifiée sont désactivées, y compris la date spécifiée par rangeEnd. Pour ne désactiver qu’un seul jour, utilisez un objet Date unique qui spécifie une date du tableau. Les valeurs de temps sont mises à zéro à partir de l’objet Date si elles existent.

L’exemple suivant désactive le 11 janvier 2006, la période du 23 janvier au 10 février 2006, ainsi que toutes les dates à partir du 1er mars 2006.

disabledRanges="{[new Date(2006,0,11), {rangeStart:
      new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
      {rangeStart: new Date(2006,2,1)}]}"

La définition de cette propriété change immédiatement l’apparence du contrôle DateChooser si les états désactivés sont inclus dans les propriétés displayedMonth et displayedYear.

La valeur par défaut est [].

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement disabledRangesChanged .

Utilisée avec la propriété displayedYear, la propriété displayedMonth spécifie le mois affiché dans le contrôle DateChooser. Les numéros de mois sont basés sur zéro. Ainsi, janvier a la valeur 0 et décembre 11. La définition de cette propriété change immédiatement l’apparence du contrôle DateChooser. La valeur par défaut est le numéro du mois de la date d’aujourd’hui.

La valeur par défaut est le mois en cours.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement displayedMonthChanged .

Utilisée avec la propriété displayedMonth, la propriété displayedYear détermine l’année affichée dans le contrôle DateChooser. La définition de cette propriété change immédiatement l’apparence du contrôle DateChooser.

La valeur par défaut est l’année en cours.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement displayedYearChanged .

Contient une référence au contrôle DateChooser enfermé par le contrôle DateField. La classe utilisée peut être définie avec dropdownFactory dans la mesure où elle prolonge DateChooser.

Objet IFactory qui crée une instance dérivée du contrôle DateChooser à utiliser comme choix de dates. La valeur par défaut est un objet IFactory du contrôle DateChooser.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dropdownFactoryChanged .

Jour de la semaine (0 à 6, dont 0 est le premier élément du tableau dayNames) à afficher dans la première colonne du contrôle DateChooser. La définition de cette propriété modifie l’ordre d’affichage des colonnes des jours.

La valeur par défaut est 0 (Sunday).

Format de la date affichée dans le champ de texte. Cette propriété peut contenir toute combinaison de "MM", "DD", "AA", "AAAA", des caractères de délimitation et de ponctuation.

La valeur par défaut est "MM/DD/YYYY".

Fonction utilisée pour mettre en forme la date affichée dans la zone de texte du contrôle DateField. Si aucune fonction n’est spécifiée, le format par défaut est utilisé.

La fonction prend un objet Date comme argument et renvoie une chaîne au format à afficher, comme l’illustre l’exemple suivant :

      public function formatDate(currentDate:Date):String {
          ...
          return dateString;
      }

Si vous autorisez l’utilisateur à saisir une date dans le champ de texte du contrôle DateField et que vous définissez une fonction de mise en forme à l’aide de la propriété labelFunction, vous devez spécifier une fonction pour la propriété parseFunction qui convertit la chaîne de caractères saisie en objet Date pouvant être utilisé par le contrôle DateField, ou définir la propriété parseFunction sur null.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelFunctionChanged .

Eléments de l’API associés

Lorsqu’un composant est utilisé en tant que rendu d’élément supplémentaire ou éditeur d’élément supplémentaire, Flex initialise la propriété listData du composant avec les données appropriées du contrôle List. Le composant peut ensuite utiliser la propriété listData pour initialiser la propriété data du rendu d’élément supplémentaire ou de l’éditeur d’élément supplémentaire.

Vous ne définissez pas cette propriété dans MXML ou ActionScript. Flex la définit lorsque le composant est utilisé comme rendu d’élément supplémentaire ou éditeur d’élément supplémentaire.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement dataChange .

Eléments de l’API associés

Dernière année sélectionnable du contrôle.

La valeur par défaut est 2100.

Première année sélectionnable du contrôle.

La valeur par défaut est 1900.

Noms des mois affichés au haut du contrôle. La propriété monthSymbol est ajoutée à la fin de la valeur spécifiée par la propriété monthNames, ce qui est utile dans des langues comme le japonais.

La valeur par défaut est [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ].

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement monthNamesChanged .

Cette propriété est ajoutée à la fin de la valeur spécifiée par la propriété monthNames afin de définir les noms des mois affichés en haut du contrôle. Certaines langues, comme le japonais, utilisent un symbole supplémentaire après le nom des mois.

La valeur par défaut est "".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement monthSymbolChanged .

Fonction utilisée pour analyser la date saisie sous forme de texte dans le champ de texte du contrôle DateField et renvoyer un objet Date au contrôle. Si aucune fonction n’est spécifiée, Flex utilise la fonction par défaut. Si vous définissez la propriété parseFunction, elle doit généralement effectuer l’inverse de la fonction spécifiée pour la propriété labelFunction.

La fonction prend deux arguments et renvoie un objet Date au contrôle DateField, comme l’illustre l’exemple suivant :

      public function parseDate(valueString:String, inputFormat:String):Date {
          ...
          return newDate
      }

L’argument valueString contient ici la chaîne de caractères saisie par l’utilisateur dans le champ de texte et l’argument inputFormat contient la mise en forme de la chaîne. Par exemple, si vous autorisez uniquement l’utilisateur à saisir une chaîne de caractères utilisant deux caractères pour le mois, le jour et l’année, « MM/DD/AA » est transmis à l’argument inputFormat.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement parseFunctionChanged .

Eléments de l’API associés

Période au cours de laquelle il est possible de sélectionner des dates. Par exemple, une date comprise entre 04-12-2006 et 04-12-2007 peut être sélectionnée, mais les dates hors de cette période sont désactivées.

Cette propriété accepte un objet comme paramètre. L’objet contient deux propriétés : rangeStart et rangeEnd, de type Date. Si vous ne spécifiez que la propriété rangeStart, toutes les dates qui se trouvent après la date spécifiée sont activées. Si vous ne spécifiez que la propriété rangeEnd, toutes les dates qui se trouvent avant la date spécifiée sont activées. Pour n’activer qu’un seul jour d’un contrôle DateChooser, vous pouvez transmettre directement un objet Date. Les valeurs de temps sont mises à zéro à partir de l’objet Date si elles existent.

L’exemple suivant active uniquement la période allant du 1er janvier 2006 au 30 juin 2006. Les mois qui se situent avant janvier et après juin n’apparaissent pas dans le contrôle DateChooser.

selectableRange="{{rangeStart : new Date(2006,0,1),
      rangeEnd : new Date(2006,5,30)}}"

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement selectableRangeChanged .

Date, telle qu’elle est sélectionnée dans le contrôle DateChooser. Accepte un objet Date comme paramètre. Si l’objet Date entrant comporte toute valeur de temps, ces valeurs sont mises à zéro.

Maintenir la touche Ctrl enfoncée tout en sélectionnant la date actuellement sélectionnée, définit la propriété selectedDate sur null et distribue l’événement change.

La valeur par défaut est null.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement selectedDateChanged .

Si la valeur est true, indique que la date d’aujourd’hui est mise en surbrillance dans le contrôle DateChooser. La définition de cette propriété change immédiatement l’apparence du contrôle DateChooser.

La valeur par défaut est true.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement showTodayChanged .

Permet de parcourir les années. Lorsque la valeur est true, un bouton vers le haut et le bas s’affiche à droite de l’année affichée. Vous pouvez utiliser ces boutons pour changer l’année en cours. Ces boutons apparaissent à gauche de l’année dans les langues où l’année vient après le mois dans le format de date.

La valeur par défaut est false.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement yearNavigationEnabledChanged .