Structure MCHITTESTINFO (commctrl.h)

Contient des informations spécifiques aux points de test d’accès pour un contrôle de calendrier mensuel. Cette structure est utilisée avec le message MCM_HITTEST et la macro MonthCal_HitTest correspondante.

Syntaxe

typedef struct {
  UINT       cbSize;
  POINT      pt;
  UINT       uHit;
  SYSTEMTIME st;
  RECT       rc;
  int        iOffset;
  int        iRow;
  int        iCol;
} MCHITTESTINFO, *PMCHITTESTINFO;

Membres

cbSize

Type : UINT

Taille de cette structure, en octets.

pt

Type : POINT

Point à tester.

uHit

Type : UINT

Membre de sortie qui reçoit un indicateur de bits représentant le résultat de l’opération de test d’accès. Cette valeur est l’une des suivantes :

Valeur	Signification
MCHT_CALENDARBK	Le point donné était en arrière-plan du calendrier.
MCHT_CALENDARCONTROL	Le point donné se trouve en dehors de n’importe quel calendrier, mais dans le calendrier contrôle RECT.
MCHT_CALENDARDATE	Le point donné se trouvait à une date particulière dans le calendrier. La structure SYSTEMTIME de lpMCHitTest>st est définie sur la date au point donné.
MCHT_CALENDARDATEMIN	Le point donné était au-dessus de la ou des dates minimales dans le calendrier.
MCHT_CALENDARDATEMAX	Le point donné était au-dessus de la ou les dates maximales du calendrier.
MCHT_CALENDARDATENEXT	Le point donné était sur une date du mois suivant (partiellement affiché à la fin du mois actuellement affiché). Si l’utilisateur clique ici, le calendrier des mois fait défiler son affichage jusqu’au mois ou à l’ensemble de mois suivant.
MCHT_CALENDARDATEPREV	Le point donné était au-dessus d’une date du mois précédent (partiellement affiché à la fin du mois actuellement affiché). Si l’utilisateur clique ici, le calendrier des mois fait défiler son affichage vers le mois précédent ou l’ensemble de mois.
MCHT_CALENDARDAY	Le point donné était sur une abréviation de jour (« ven », par exemple). La structure SYSTEMTIME de lpMCHitTest>st est définie sur la date correspondante dans la ligne supérieure.
MCHT_CALENDARWEEKNUM	Le point donné était sur un numéro de semaine (MCS_WEEKNUMBERS style uniquement). La structure SYSTEMTIME de lpMCHitTest>st est définie sur la date correspondante dans la colonne la plus à gauche.
MCHT_NOWHERE	Le point donné n’était pas sur le contrôle du calendrier du mois ou il se trouvait dans une partie inactive du contrôle.
MCHT_TITLEBK	Le point donné était sur l’arrière-plan d’un titre d’un mois.
MCHT_TITLEBTNNEXT	Le point donné était sur le bouton situé en haut à droite du contrôle. Si l’utilisateur clique ici, le calendrier des mois fait défiler son affichage jusqu’au mois ou à l’ensemble de mois suivant.
MCHT_TITLEBTNPREV	Le point donné était sur le bouton en haut à gauche du contrôle. Si l’utilisateur clique ici, le calendrier des mois fait défiler son affichage vers le mois précédent ou l’ensemble de mois.
MCHT_TITLEMONTH	Le point donné était dans la barre de titre d’un mois, sur un nom de mois.
MCHT_TITLEYEAR	Le point donné était dans la barre de titre d’un mois, sur la valeur de l’année.

st

Type : SYSTEMTIME

Reçoit des informations de date et d’heure spécifiques à l’emplacement testé.

rc

Type : RECT

Emplacement testé.

iOffset

Type : int

Lorsque vous affichez plusieurs calendriers, il s’agit du décalage du calendrier au point testé (base zéro).

iRow

Type : int

Numéro de ligne de la grille de calendrier sur laquelle le point d’accès donné était dépassé. Exemple : si vous avez testé le 8ème d’un mois, c’est-à-dire la deuxième semaine du mois, iRow en sera un, car l’index de la ligne est un index de ligne de base zéro.

iCol

Type : int

Numéro de colonne de la grille de calendrier sur laquelle le point donné était terminé. Par exemple, si votre semaine commence le dimanche et que le 1er du mois est le vendredi, le test d’accès au 1er retourne cinq (5) pour iCol, puisque vendredi se trouve dans la cinquième colonne à partir du début de la ligne, à l’aide d’un index de colonne de base zéro.

Notes

Les colonnes et les lignes de ce contrôle utilisent un système d’index de base zéro, c’est-à-dire que la première colonne ou ligne a un index de zéro.

Spécifications

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