Partager via

Structure MCHITTESTINFO (commctrl.h)

  • Article

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