Structure NMDATETIMEFORMATA (commctrl.h)

Contient des informations sur une partie de la chaîne de format qui définit un champ de rappel dans un contrôle sélecteur de date et d’heure (DTP). Il porte la sous-chaîne qui définit le champ de rappel et contient une mémoire tampon pour recevoir la chaîne qui sera affichée dans le champ de rappel. Cette structure est utilisée avec le code de notification DTN_FORMAT .

Syntaxe

typedef struct tagNMDATETIMEFORMATA {
  NMHDR      nmhdr;
  LPCSTR     pszFormat;
  SYSTEMTIME st;
  LPCSTR     pszDisplay;
  CHAR       szDisplay[64];
} NMDATETIMEFORMATA, *LPNMDATETIMEFORMATA;

Membres

nmhdr

Type : NMHDR

Structure NMHDR qui contient des informations sur le code de notification.

pszFormat

Type : LPCTSTR

Pointeur vers la sous-chaîne qui définit un champ de rappel de contrôle DTP. La sous-chaîne se compose d’un ou plusieurs caractères « X » suivis d’un caractère NULL. (Pour plus d’informations sur les champs de rappel, consultez Champs de rappel.)

st

Type : SYSTEMTIME

Structure SYSTEMTIME qui contient la date et l’heure à mettre en forme.

pszDisplay

Type : LPCTSTR

Pointeur vers une chaîne terminée par null qui contient le texte d’affichage du contrôle. Par défaut, il s’agit de l’adresse du membre szDisplay de cette structure. Il est acceptable d’avoir pszDisplay point vers une chaîne existante. Dans ce cas, vous n’avez pas besoin d’affecter une valeur à szDisplay. Toutefois, la chaîne vers laquelle pszDisplay pointe doit rester valide jusqu’à ce qu’une autre notification DTN_FORMAT soit envoyée ou jusqu’à ce que le contrôle soit détruit.

szDisplay[64]

Type : TCHAR

Mémoire tampon de 64 caractères qui doit recevoir la chaîne sans fin que le contrôle DTP affichera. Il n’est pas nécessaire de remplir la mémoire tampon entière.

Remarques

Notes

L’en-tête commctrl.h définit NMDATETIMEFORMAT comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	commctrl.h