commctrl.h

Estructura MCHITTESTINFO

Definición

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

Contiene información específica para puntos de prueba para un control de calendario mensual. Esta estructura se usa con el mensaje MCM_HITTEST y la macro correspondiente MonthCal_HitTest.

Descripción

cbSize
Tamaño de esta estructura, en bytes.
pt
Point to be hit-tested.
uHit

Miembro de salida que recibe una bandera que representa el resultado de la operación de prueba de punto. Este valor puede ser uno de los siguientes:

ValorSignificado
MCHT_CALENDARBKEl punto dado estaba en lo fondo del calendario.
MCHT_CALENDARCONTROLEl punto dado está fuera de cualquier calendario pero dentro del rectángulo del control de calendario.
MCHT_CALENDARDATEEl punto dado estaba en una fecha en particular del calendario. La estructura SYSTEMTIME en lpMCHitTest>st es asignada a la fecha en el punto dado.
MCHT_CALENDARDATEMINEl punto dado estaba sobre la fecha mínima en el calendario.
MCHT_CALENDARDATEMAXEl punto dado estaba sobre la fecha máxima en el calendario.
MCHT_CALENDARDATENEXTEl punto dado estaba sobre una fecha del mes siguiente (parcialmente mostrado al final del mes actualmente mostrado). Si el usuario hace click ahí, el calendario mensual se desplazará para mostrar el siguiente mes o el siguiente conjunto de meses.
MCHT_CALENDARDATEPREVEl punto dado estaba sobre una fecha del mes anterior (parcialmente mostrado al principio del mes actualmente mostrado). Si el usuario hace click ahí, el calendario mensual se desplazará para mostrar el mes anterior o el conjunto anterior de meses.
MCHT_CALENDARDAYEl punto dado estaba sobre la abreviatura de yn día de semana ("Vie", por ejemplo). La estructura SYSTEMTIME en lpMCHitTest>st es asignada a la fecha correspondiente en la primera fila.
MCHT_CALENDARWEEKNUMEl punto dado estaba sonre un número de semana (sólo con el estilo MCS_WEEKNUMBERS). La estructura SYSTEMTIME en lpMCHitTest->st es asignada a la fecha correspondiente en la columna de la izquierda.
MCHT_NOWHEREEl punto dado no estaba en el control de calendario mensual, o estaba en una porción inactiva del control.
MCHT_TITLEBKEl punto dado estaba sobre el fondo del título de un mes.
MCHT_TITLEBTNNEXTEl punto dado estaba sobre el botón en la esquina superior derecha del control. Si el usuario hace click ahí, el calendario mensual se desplazará para mostrar el siguiente mes o el siguiente conjunto de meses.
MCHT_TITLEBTNPREVEl punto dado estaba sobre el botón en la esquina superior izauierda del control. Si el usuario hace click ahí, el calendario mensual se desplazará para mostrar el mes anterior o el conjunto anterior de meses.
MCHT_TITLEMONTHEl punto dadoe estaba en una barra de título de mes, sobre el nombre de mes.
MCHT_TITLEYEAREl punto dado estaba en una barra de título de mes, sobre valor del año.
st
Recibe la información de fecha y hora específica para posición en que estaba el punto de prueba.
rc
Localización del punto de prueba.
iOffset
Cuando se muestra más de un calendario, este es el desplazamiento del calendario en el punto de prueba (empezando en cero).
iRow
El número de fila para la cuadrícula del calendario sobre el que está el punto de prueba. Por ejemplo: si se prueba sobre el día 8 de un mes, que esté en la sengunda semana del mes, iRow será uno ya que el índice de la fila contando las filas empezando en cero.
iCol
El número de columna para la cuadrícula del calendario sobre el que está el punto de prueba. Por ejemplo, si la semana empieza en domingo y el primero, hacer prueba de punto sobre el primero de mes retornará 5 para iCol, ya que el viernes estará en la quinta columna desde el principio de la fila, empezando a contar en cero.

Observaciones

Las columnas y filas en el control usan un sistema de índices empezando en cero, es decir, la primera columna o fila tiene el valor de índice cero.