Struttura MCHITTESTINFO (commctrl.h)

  • Articolo

Contiene informazioni specifiche per i punti di hit testing per un controllo del calendario mensile. Questa struttura viene utilizzata con il messaggio MCM_HITTEST e la macro MonthCal_HitTest corrispondente.

Sintassi

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

Members

cbSize

Tipo: UINT

Dimensioni di questa struttura, in byte.

pt

Tipo: POINT

Punto da sottoporre a hit test.

uHit

Tipo: UINT

Membro di output che riceve un flag di bit che rappresenta il risultato dell'operazione di hit test. Questo valore sarà uno dei seguenti:

Valore Significato
MCHT_CALENDARBK
 Il punto specificato era in background del calendario.
MCHT_CALENDARCONTROL
 Il punto specificato è esterno a qualsiasi calendario, ma all'interno del calendario controlla RECT.
MCHT_CALENDARDATE
 Il punto specificato era in una data specifica all'interno del calendario. La struttura SYSTEMTIME in lpMCHitTest>st è impostata sulla data in corrispondenza del punto specificato.
MCHT_CALENDARDATEMIN
 Il punto specificato è stato superiore alla data minima del calendario.
MCHT_CALENDARDATEMAX
 Il punto specificato è stato superiore alla data massima del calendario.
MCHT_CALENDARDATENEXT
 Il punto specificato è stato superato da una data del mese successivo (parzialmente visualizzata alla fine del mese attualmente visualizzato). Se l'utente fa clic qui, il calendario mensile scorrerà la visualizzazione fino al mese successivo o al set di mesi successivi.
MCHT_CALENDARDATEPREV
 Il punto specificato è stato superato da una data del mese precedente (parzialmente visualizzata alla fine del mese attualmente visualizzato). Se l'utente fa clic qui, il calendario mensile scorrerà la visualizzazione fino al mese precedente o al set di mesi.
MCHT_CALENDARDAY
 Il punto specificato era in un'abbreviazione di giorno ("Fri", ad esempio). La struttura SYSTEMTIME in lpMCHitTest>st è impostata sulla data corrispondente nella riga superiore.
MCHT_CALENDARWEEKNUM
 Il punto specificato era superiore a un numero di settimana (solo stile MCS_WEEKNUMBERS ). La struttura SYSTEMTIME in lpMCHitTest>st è impostata sulla data corrispondente nella colonna più a sinistra.
MCHT_NOWHERE
 Il punto specificato non era nel controllo del calendario mensile o era in una parte inattiva del controllo.
MCHT_TITLEBK
 Il punto specificato era sullo sfondo del titolo di un mese.
MCHT_TITLEBTNNEXT
 Il punto specificato si trovava sopra il pulsante nell'angolo superiore destro del controllo. Se l'utente fa clic qui, il calendario mensile scorrerà la visualizzazione fino al mese successivo o al set di mesi successivi.
MCHT_TITLEBTNPREV
 Il punto specificato è posizionato sul pulsante nell'angolo superiore sinistro del controllo. Se l'utente fa clic qui, il calendario mensile scorrerà la visualizzazione fino al mese precedente o al set di mesi.
MCHT_TITLEMONTH
 Il punto specificato si trovava nella barra del titolo di un mese, oltre un nome di mese.
MCHT_TITLEYEAR
 Il punto specificato si trovava nella barra del titolo di un mese, rispetto al valore dell'anno.

st

Tipo: SYSTEMTIME

Riceve informazioni di data e ora specifiche per la posizione sottoposta a hit test.

rc

Tipo: RECT

Posizione sottoposta a hit test.

iOffset

Tipo: int

Quando si visualizzano più calendari, si tratta dell'offset del calendario in corrispondenza del punto di hit test (in base zero).

iRow

Tipo: int

Numero di riga per la griglia del calendario su cui è stato superato il punto di hit specificato. Esempio: se è stato eseguito il hit test dell'8 di un mese, ovvero nella seconda settimana del mese, iRow sarà uno perché l'indice della riga è in base zero.

iCol

Tipo: int

Numero di colonna per la griglia del calendario su cui si trovava il punto specificato. Ad esempio, se la settimana inizia domenica e il primo del mese è venerdì, l'hit testing restituirà cinque (5) per iCol, dal momento che Venerdì è nella quinta colonna dall'inizio della riga, usando un indice di colonna in base zero.

Commenti

Le colonne e le righe in questo controllo usano un sistema di indici in base zero, ovvero la prima colonna o riga ha un indice pari a zero.

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Intestazione commctrl.h