DateGadget()

Syntaxe

Resultat = DateGadget(#Gadget, x, y, Largeur, Hauteur [, Masque$ [, Date [, Options]]])

Crée un champ de saisie (identique à un StringGadget()) dans la GadgetList en cours, dans lequel il sera possible d'entrer une date et/ou une heure. Ce gadget utilise le même formatage que la bibliothèque Date. Il est par exemple possible d'utiliser FormatDate() pour afficher le résultat renvoyé par GetGadgetState() dans le format approprié. Si #PB_Any est utilisé pour le paramètre '#Gadget', le numéro du nouveau gadget sera renvoyé dans 'Resultat'. #Gadget sera le numéro retourné par la fonction EventGadget().

Le paramètre 'Options' est facultatif et permet de spécifier le format dans lequel la date sera saisie (voir FormatDate() pour la syntaxe du masque). Important: le gadget ne supporte pas l'affichage des secondes, donc si "%ss" est indiqué dans le paramètre Masque$, il sera simplement ignoré. Si aucun masque n'est spécifié (ou que le masque est vide), le masque par défaut sera utilisé. Le masque peut être modifié à l'aide de la commande SetGadgetText().

Le paramètre 'Date' est facultatif et permet d'initialiser le gadget avec la date voulue. Si ce paramètre est omis ou s'il est mis à 0, alors la date actuelle sera utilisée.

Par défaut le gadget a un bouton pour afficher un calendrier à partir duquel l'utilisateur peut choisir une date facilement (voir l'image ci-dessous). Vous pouvez changer cela en spécifiant la constante #PB_Date_UpDown dans le paramètre 'Options'. Dans ce cas, deux boutons (un pour monter, un pour descendre) sera présent pour permettre de modifier la date directement, sans passer par un calendrier. Cette option est seulement disponible sous Windows.

Si #PB_Date_CheckBox est spécifié dans le paramètre 'Options', le gadget aura une case à cocher à partir de laquelle l'utilisateur pourra mettre le gadget sur 'Aucune date' (si la case à cocher est décochée). Tant que la case à cocher est décochée, GetGadgetState() renverra 0. Pour changer l'état de la case à cocher, utiliser SetGadgetState() avec soit 0 (aucune date), soit avec une date valide.

GadgetToolTip() permet d'ajouter une 'mini aide' à ce gadget.

Les commandes suivantes peuvent être utilisées pour agir sur ce gadget :

- SetGadgetState(): Change la date du gadget.
- SetGadgetText(): Change le masque du gadget.
- GetGadgetState(): Renvoie la valeur numérique de la date actuellement affichée.
- GetGadgetText(): Renvoie la date actuellement affichée sous forme de texte (exactement comme elle est affichée).
- GetGadgetAttribute() avec les attributs suivants:

  #PB_Date_Minimum: Renvoie la date minimale que l'utilisateur peut choisir
  #PB_Date_Maximum: Renvoie la date maximale que l'utilisateur peut choisir avec ce gadget

- SetGadgetAttribute(): avec les attributs suivants:

  #PB_Date_Minimum: Change la date minimale que l'utilisateur peut choisir
  #PB_Date_Maximum: Change la date maximale que l'utilisateur peut choisir avec ce gadget

Ce gadget supporte les commandes SetGadgetColor() et GetGadgetColor() avec les constantes suivantes comme 'TypeCouleur':

  #PB_Gadget_BackColor      : couleur de fond
  #PB_Gadget_FrontColor     : couleur du texte pour les jours affichés
  #PB_Gadget_TitleBackColor : couleur du fond du titre du mois
  #PB_Gadget_TitleFrontColor: couleur du texte du titre du mois
  #PB_Gadget_GrayTextColor  : couleur du texte pour les jours n'appartenant pas au mois courant.

Exemple

  If OpenWindow(0, 0, 0, 250, 250,"DateGadget", #PB_Window_SystemMenu|#PB_Window_ScreenCentered)
    DateGadget(0, 10, 10, 190, 25, "Date : %dd/%mm/%yyyy Heure : %hh:%ii")
    Repeat
    Until WaitWindowEvent() = #PB_Event_CloseWindow
  EndIf

OS Supportés

Tous