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.

Arguments

#Gadget	Le numéro d'identification du nouveau gadget. #PB_Any peut être utilisé pour générer automatiquement ce numéro.
X, Y, Largeur, Hauteur	La position et les dimensions du nouveau gadget.
Masque$ (optionnel)	Le format de la date. Voir FormatDate() pour le format de ce masque. Note importante: Le gadget ne supporte pas l'affichage des secondes, donc si vous spécifiez "%ss" dans le paramètre 'Masque$, il sera tout simplement ignoré ! Si vous ne spécifiez pas de masque ou si vous spécifiez une chaîne vide, un masque par défaut sera utilisé. Le masque peut être modifié avec la fonction SetGadgetText().
Date (optionnel)	La date initialement prévue pour le gadget. Ne pas spécifier ce paramètre ou utiliser une valeur 0 permet d'afficher la date et l'heure du jour.
Options (optionnel)	Peut être une combinaison de: #PB_Date_UpDown 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). Avec cette option, deux boutons (un pour monter, un pour descendre) seront présents pour permettre de modifier la date directement, sans passer par un calendrier. Cette option est seulement disponible sous Windows. #PB_Date_CheckBox, 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.

Valeur de retour

Renvoie une valeur non nulle en cas de succès, zéro sinon.

Si #PB_Any a été utilisé pour le paramètre #Gadget, alors la valeur de retour est le numéro d'identification du gadget, généré automatiquement.

Remarques

Ce gadget utilise le même format de date que celui utilisé par les fonctions de la bibliothèque Date. Ainsi, vous pouvez, par exemple, utiliser FormatDate() pour afficher le résultat renvoyé par GetGadgetState(), avec un format personnalisé.

  - 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.
  - GetGadgetState(): Renvoie la valeur numérique de la date actuellement affichée.
  
  - SetGadgetText() : Change le masque du gadget.
  - 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
                      (Remarque: la date sélectionnable n'est pas prise en charge sous Linux.)
                      
  - 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
                      (Remarque: la date sélectionnable n'est pas prise en charge sous Linux.)
                      
  - 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.

L'évènement suivant est pris en charge par EventType():

  #PB_EventType_Change: La date a été modifiée par l'utilisateur.

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

Voir aussi

GetGadgetState(), SetGadgetState(), GetGadgetText(), SetGadgetText(), GetGadgetAttribute(), SetGadgetAttribute(), GetGadgetColor(), SetGadgetColor(), CalendarGadget(), Date(), FormatDate()

OS Supportés

Tous