NMDATETIMEFORMATA, structure (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 de 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 szDisplay membre de cette structure. Il est acceptable d’avoir pszDisplay pointer vers une chaîne existante. Dans ce cas, vous n’avez pas besoin d’affecter une valeur à szDisplay. Toutefois, la chaîne qui pszDisplay points 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 terminée par zéro que le contrôle DTP affichera. Il n’est pas nécessaire de remplir la mémoire tampon entière.

Remarques

Note

L’en-tête commctrl.h définit NMDATETIMEFORMAT comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	commctrl.h