Estructura MCHITTESTINFO (commctrl.h)

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

Sintaxis

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

Miembros

cbSize

Tipo: UINT

Tamaño de esta estructura, en bytes.

pt

Tipo: POINT

Apunte a la prueba de posicionamiento.

uHit

Tipo: UINT

Miembro de salida que recibe una marca de bits que representa el resultado de la operación de prueba de posicionamiento. Este valor será uno de los siguientes:

Valor Significado
MCHT_CALENDARBK
El punto dado estaba en el fondo del calendario.
MCHT_CALENDARCONTROL
El punto dado está fuera de cualquier calendario, pero dentro de los controles de calendario RECT.
MCHT_CALENDARDATE
El punto dado estaba en una fecha determinada dentro del calendario. La estructura SYSTEMTIME de lpMCHitTest>st se establece en la fecha en el punto especificado.
MCHT_CALENDARDATEMIN
El punto dado era sobre las fechas mínimas del calendario.
MCHT_CALENDARDATEMAX
El punto dado era superior a las fechas máximas del calendario.
MCHT_CALENDARDATENEXT
El punto dado se encontraba en una fecha del mes siguiente (se muestra parcialmente al final del mes que se muestra actualmente). Si el usuario hace clic aquí, el calendario del mes se desplazará hasta el mes siguiente o conjunto de meses.
MCHT_CALENDARDATEPREV
El punto dado ha superado una fecha del mes anterior (se muestra parcialmente al final del mes que se muestra actualmente). Si el usuario hace clic aquí, el calendario del mes desplazará su presentación al mes anterior o al conjunto de meses.
MCHT_CALENDARDAY
El punto dado era superior a una abreviatura de día ("Fri", por ejemplo). La estructura SYSTEMTIME de lpMCHitTest>st se establece en la fecha correspondiente de la fila superior.
MCHT_CALENDARWEEKNUM
El punto dado era a lo largo de una semana (solo MCS_WEEKNUMBERS estilo). La estructura SYSTEMTIME de lpMCHitTest>st se establece en la fecha correspondiente de la columna situada más a la izquierda.
MCHT_NOWHERE
El punto dado no estaba en el control de calendario del mes o estaba en una parte inactiva del control.
MCHT_TITLEBK
El punto dado estaba sobre el fondo del título de un mes.
MCHT_TITLEBTNNEXT
El punto dado estaba sobre el botón situado en la esquina superior derecha del control. Si el usuario hace clic aquí, el calendario del mes se desplazará hasta el mes siguiente o conjunto de meses.
MCHT_TITLEBTNPREV
El punto dado estaba sobre el botón situado en la esquina superior izquierda del control. Si el usuario hace clic aquí, el calendario del mes desplazará su presentación al mes anterior o al conjunto de meses.
MCHT_TITLEMONTH
El punto dado estaba en la barra de título de un mes, a lo largo de un nombre de mes.
MCHT_TITLEYEAR
El punto dado estaba en la barra de título de un mes, durante el valor del año.

st

Tipo: SYSTEMTIME

Recibe información de fecha y hora específica de la ubicación que se ha probado.

rc

Tipo: RECT

Ubicación probada de posicionamiento.

iOffset

Tipo: int

Al mostrar más de un calendario, este es el desplazamiento del calendario en el punto probado por posicionamiento (basado en cero).

iRow

Tipo: int

Número de fila de la cuadrícula de calendario en la que ha terminado el punto de acierto especificado. Ejemplo: si ha probado el 8 de un mes, que se encuentra en la segunda semana del mes, iRow será uno, ya que el índice de la fila es de base cero.

iCol

Tipo: int

Número de columna de la cuadrícula de calendario en la que se ha terminado el punto especificado. Por ejemplo, si la semana comienza el domingo y la primera del mes es viernes, las pruebas de posicionamiento devolverán cinco (5) para iCol, ya que el viernes está en la quinta columna desde el principio de la fila, utilizando un índice de columna de base cero.

Comentarios

Las columnas y filas de este control usan un sistema de índices de base cero, es decir, la primera columna o fila tiene un índice de cero.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h