Sélecteur de date et d’heure

Article
06/13/2023

Cette section contient des informations sur les éléments d’API utilisés avec les contrôles de sélecteur de date et d’heure.

Vues d'ensemble

Rubrique	Contenu
À propos des contrôles sélecteur de date et d’heure	Un contrôle sélecteur de date et d’heure (DTP) fournit une interface simple et intuitive à travers laquelle échanger des informations de date et d’heure avec un utilisateur.
Utilisation des contrôles sélecteur de date et d’heure	Cette section fournit des informations et un exemple de code pour l’implémentation de contrôles de sélecteur de date et d’heure.

Macros

Rubrique	Contenu
DateTime_CloseMonthCal	Ferme le contrôle sélecteur de date et d’heure (DTP). Utilisez cette macro ou envoyez explicitement le message DTM_CLOSEMONTHCAL .
DateTime_GetDateTimePickerInfo	Obtient des informations pour un contrôle de sélecteur de date et d’heure (DTP) spécifié.
DateTime_GetIdealSize	Obtient la taille nécessaire pour afficher le contrôle sans découpage. Utilisez cette macro ou envoyez explicitement le message DTM_GETIDEALSIZE .
DateTime_GetMonthCal	Obtient le handle dans le contrôle de calendrier du mois enfant d’un sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer le message DTM_GETMONTHCAL explicitement.
DateTime_GetMonthCalColor	Obtient la couleur d’une partie donnée du calendrier des mois dans un contrôle sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer le message DTM_GETMCCOLOR explicitement.
DateTime_GetMonthCalFont	Obtient la police que le contrôle calendrier du mois enfant du contrôle de sélection de date et d’heure (DTP) utilise actuellement. Vous pouvez utiliser cette macro ou envoyer le message DTM_GETMCFONT explicitement.
DateTime_GetMonthCalStyle	Obtient le style d’un contrôle DTP spécifié. Utilisez cette macro ou envoyez explicitement le message DTM_GETMCSTYLE .
DateTime_GetRange	Obtient les heures système minimales et maximales actuelles autorisées pour un contrôle sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer le message DTM_GETRANGE explicitement.
DateTime_GetSystemtime	Obtient l’heure actuellement sélectionnée à partir d’un contrôle sélecteur de date et d’heure (DTP) et la place dans une structure SYSTEMTIME spécifiée. Vous pouvez utiliser cette macro ou envoyer le message DTM_GETSYSTEMTIME explicitement.
DateTime_SetFormat	Définit l’affichage d’un contrôle sélecteur de date et d’heure (DTP) en fonction d’une chaîne de format donnée. Vous pouvez utiliser cette macro ou envoyer le message DTM_SETFORMAT explicitement.
DateTime_SetMonthCalColor	Définit la couleur d’une partie donnée du calendrier des mois dans un contrôle sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer le message DTM_SETMCCOLOR explicitement.
DateTime_SetMonthCalFont	Définit la police à utiliser par le contrôle calendrier du mois enfant du contrôle de sélection de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer explicitement le message DTM_SETMCFONT .
DateTime_SetMonthCalStyle	Définit le style d’un contrôle DTP spécifié. Utilisez cette macro ou envoyez le message DTM_SETMCSTYLE explicitement.
DateTime_SetRange	Définit les heures système minimales et maximales autorisées pour un contrôle sélecteur de date et d’heure (DTP). Vous pouvez utiliser cette macro ou envoyer le message DTM_SETRANGE explicitement.
DateTime_SetSystemtime	Définit un contrôle sélecteur de date et d’heure (DTP) sur une date et une heure données. Vous pouvez utiliser cette macro ou envoyer le message DTM_SETSYSTEMTIME explicitement.

Messages

Rubrique	Contenu
DTM_CLOSEMONTHCAL	Ferme un contrôle DTP. Envoyez ce message explicitement ou à l’aide de la macro DateTime_CloseMonthCal .
DTM_GETDATETIMEPICKERINFO	Obtient des informations sur un contrôle sélecteur de date et d’heure (DTP).
DTM_GETIDEALSIZE	Obtient la taille nécessaire pour afficher le contrôle sans découpage. Envoyez ce message explicitement ou à l’aide de la macro DateTime_GetIdealSize .
DTM_GETMCCOLOR	Obtient la couleur d’une partie donnée du calendrier des mois dans un contrôle sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_GetMonthCalColor .
DTM_GETMCFONT	Obtient la police que le contrôle calendrier du mois enfant du contrôle de sélection de date et d’heure (DTP) utilise actuellement. Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_GetMonthCalFont .
DTM_GETMCSTYLE	Obtient le style d’un contrôle DTP. Envoyez ce message explicitement ou à l’aide de la macro DateTime_GetMonthCalStyle .
DTM_GETMONTHCAL	Obtient le handle dans le contrôle de calendrier du mois enfant d’un sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_GetMonthCal .
DTM_GETRANGE	Obtient les heures système minimales et maximales actuelles autorisées pour un contrôle sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_GetRange .
DTM_GETSYSTEMTIME	Obtient l’heure actuellement sélectionnée à partir d’un contrôle sélecteur de date et d’heure (DTP) et la place dans une structure SYSTEMTIME spécifiée. Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_GetSystemtime .
DTM_SETFORMAT	Définit l’affichage d’un contrôle sélecteur de date et d’heure (DTP) en fonction d’une chaîne de format donnée. Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_SetFormat .
DTM_SETMCCOLOR	Définit la couleur d’une partie donnée du calendrier des mois dans un contrôle sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_SetMonthCalColor .
DTM_SETMCFONT	Définit la police à utiliser par le contrôle calendrier du mois enfant du contrôle de sélection de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_SetMonthCalFont .
DTM_SETMCSTYLE	Définit le style d’un contrôle DTP. Envoyez ce message explicitement ou à l’aide de la macro DateTime_SetMonthCalStyle .
DTM_SETRANGE	Définit les heures système minimales et maximales autorisées pour un contrôle de sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_SetRange .
DTM_SETSYSTEMTIME	Définit l’heure dans un contrôle de sélecteur de date et d’heure (DTP). Vous pouvez envoyer ce message explicitement ou utiliser la macro DateTime_SetSystemtime .

Notifications

Rubrique	Contenu
DTN_CLOSEUP	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) lorsque l’utilisateur ferme le calendrier déroulant du mois. Le calendrier mensuel est fermé lorsque l’utilisateur choisit une date dans le calendrier du mois ou clique sur la flèche déroulante pendant que le calendrier est ouvert.
DTN_DATETIMECHANGE	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) chaque fois qu’une modification se produit. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
DTN_DROPDOWN	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) lorsque l’utilisateur active le calendrier déroulant du mois.
DTN_FORMAT	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) pour demander l’affichage du texte dans un champ de rappel. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
DTN_FORMATQUERY	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) pour récupérer la taille maximale autorisée de la chaîne qui sera affichée dans un champ de rappel. Ce code de notification est envoyé sous la forme d’un message WM_NOTIFY .
DTN_USERSTRING	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) lorsqu’un utilisateur termine la modification d’une chaîne dans le contrôle. Ce code de notification est envoyé uniquement par les contrôles DTP qui sont définis sur le style DTS_APPCANPARSE . Ce message est envoyé sous la forme d’un message WM_NOTIFY .
DTN_WMKEYDOWN	Envoyé par un contrôle de sélecteur de date et d’heure (DTP) lorsque l’utilisateur tape dans un champ de rappel. Ce message est envoyé sous la forme d’un message WM_NOTIFY .
NM_KILLFOCUS (date et heure)	Avertit la fenêtre parente d’un contrôle de sélecteur de date et d’heure que le contrôle a perdu le focus d’entrée. NM_KILLFOCUS (date heure) est envoyé sous la forme d’un message WM_NOTIFY .
NM_SETFOCUS (date et heure)	Notifie la fenêtre parente d’un contrôle de sélecteur de date et d’heure que le contrôle a reçu le focus d’entrée. NM_SETFOCUS (date heure) est envoyé sous la forme d’un message WM_NOTIFY .

Structures

Rubrique	Contenu
DATETIMEPICKERINFO	Contient des informations sur un contrôle DTP.
NMDATETIMECHANGE	Contient des informations sur une modification qui a eu lieu dans un contrôle de sélecteur de date et d’heure (DTP). Cette structure est utilisée avec le code de notification DTN_DATETIMECHANGE .
NMDATETIMEFORMAT	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 contient 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 .
NMDATETIMEFORMATQUERY	Contient des informations sur un champ de rappel de contrôle de sélecteur de date et d’heure (DTP). Il contient une sous-chaîne (extraite de la chaîne de format du contrôle) qui définit un champ de rappel. La structure reçoit la taille maximale autorisée du texte qui sera affiché dans le champ de rappel. Cette structure est utilisée avec le code de notification DTN_FORMATQUERY .
NMDATETIMESTRING	Contient des informations spécifiques à une opération de modification qui a eu lieu dans un contrôle de sélecteur de date et d’heure (DTP). Ce message est utilisé avec le code de notification DTN_USERSTRING .
NMDATETIMEWMKEYDOWN	Contient les informations utilisées pour décrire et gérer un code de notification DTN_WMKEYDOWN .

Constantes

Rubrique	Contenu
Styles de contrôle du sélecteur de date et d’heure	Les styles de fenêtre répertoriés ici sont spécifiques aux contrôles de sélecteur de date et d’heure.