UDF > GUI > GuiDateTimePicker >


_GUICtrlDTP_SetFormat

Définit l'affichage à partir d'une chaîne de format donnée

#include <GuiDateTimePicker.au3>
_GUICtrlDTP_SetFormat ( $hWnd, $sFormat )

Paramètres

$hWnd Handle du contrôle
$sFormat Chaîne qui définit le format souhaité. Mettre ce paramètre à vide pour réinitialiser le contrôle à la chaîne de format par défaut pour le style courant. Vous pouvez utiliser les chaînes de format suivantes:
    "d" - Le jour sur un ou deux chiffres
    "dd" - Le jour sur deux chiffres. Les valeurs à un seul chiffre sont précédées d'un zéro
    "ddd" - L'abréviation du jour de la semaine sur trois caractères
    "dddd"- Le nom complet du jour de la semaine
    "h" - L'heure sur un ou deux chiffres au format 12 heures
    "hh" - L'heure sur deux chiffres au format 12 heures
    "H" - L'heure sur un ou deux chiffres au format 24 heures
    "HH" - L'heure sur deux chiffres au format 24 heures
    "m" - Les minutes sur un ou deux chiffres
    "mm"- Les minutes sur deux chiffres
    "M" - Le numéro du mois sur un ou deux chiffres
    "MM" - Le numéro du mois sur deux chiffres
    "MMM"- L'abréviation du mois sur trois caractères
    "MMMM"- Le nom complet du mois
    "t" - L'abréviation AM/PM sur seule lettre
    "tt" - L'abréviation AM/PM sur deux lettres
    "yy"- Les deux derniers chiffres de l'année
    "yyyy"- L'année complète

Valeur de retour

Succès: Reourne True.
Échec: Reourne False.

Remarques

Il est possible d'inclure des caractères supplémentaires dans la chaîne de format pour produire un affichage plus riche.
Cependant, les caractères hors format doivent être placées entre guillemets simples.
Par exemple, la chaîne de format "Aujourd'hui, il est:
    'hh':'m':'s ddddMMMdd', 'yyy" produirait la sortie "Aujourd'hui, il est: 04:22:31 Tuesday Mar 23, 1996".

Remarque: Un contrôle DTP détecte les changements des paramètres régionaux quand il utilise la chaîne de format par défaut.
Si vous définissez une chaîne de format personnalisé, elle ne sera pas mise à jour en réponse à des changements des paramètres locaux.

Exemple

#include <GUIConstantsEx.au3>
#include <GuiDateTimePicker.au3>

Example()

Func Example()
    Local $hDTP

    ; Crée une GUI
    GUICreate("DateTimePick Set Format", 400, 300)
    $hDTP = GUICtrlGetHandle(GUICtrlCreateDate("", 2, 6, 190))

    GUISetState(@SW_SHOW)

    ; Définit le format d'affichage
    _GUICtrlDTP_SetFormat($hDTP, "ddd MMM dd, yyyy hh:mm ttt")

    ; Boucle jusqu'à ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example