Estrutura MCHITTESTINFO (commctrl.h)

Carrega informações específicas para pontos de teste de clique para um controle de calendário de mês. Essa estrutura é usada com a mensagem MCM_HITTEST e a macro MonthCal_HitTest correspondente.

Sintaxe

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

Membros

cbSize

Tipo: UINT

O tamanho dessa estrutura, em bytes.

pt

Tipo: POINT

Aponte para ser testado com clique.

uHit

Tipo: UINT

Membro de saída que recebe um sinalizador de bits que representa o resultado da operação de teste de clique. Esse valor será um dos seguintes:

Valor	Significado
MCHT_CALENDARBK	O ponto determinado estava em segundo plano do calendário.
MCHT_CALENDARCONTROL	O ponto determinado está fora de qualquer calendário, mas dentro do calendário controla RECT.
MCHT_CALENDARDATE	O ponto determinado estava em uma data específica dentro do calendário. A estrutura SYSTEMTIME em lpMCHitTest>st é definida como a data no ponto determinado.
MCHT_CALENDARDATEMIN	O ponto determinado estava acima das datas mínimas no calendário.
MCHT_CALENDARDATEMAX	O ponto determinado estava acima das datas máximas no calendário.
MCHT_CALENDARDATENEXT	O ponto determinado foi sobre uma data do mês seguinte (parcialmente exibido no final do mês exibido no momento). Se o usuário clicar aqui, o calendário do mês rolará sua exibição para o próximo mês ou conjunto de meses.
MCHT_CALENDARDATEPREV	O ponto determinado foi sobre uma data do mês anterior (parcialmente exibido no final do mês exibido no momento). Se o usuário clicar aqui, o calendário do mês rolará sua exibição para o mês ou conjunto de meses anterior.
MCHT_CALENDARDAY	O ponto determinado foi mais de uma abreviação de dia ("Sex", por exemplo). A estrutura SYSTEMTIME em lpMCHitTest>st é definida como a data correspondente na linha superior.
MCHT_CALENDARWEEKNUM	O ponto determinado foi mais de um número de semana (somente MCS_WEEKNUMBERS estilo). A estrutura SYSTEMTIME em lpMCHitTest>st é definida como a data correspondente na coluna mais à esquerda.
MCHT_NOWHERE	O ponto determinado não estava no controle de calendário do mês ou estava em uma parte inativa do controle.
MCHT_TITLEBK	O ponto determinado foi sobre o fundo do título de um mês.
MCHT_TITLEBTNNEXT	O ponto determinado estava sobre o botão no canto superior direito do controle. Se o usuário clicar aqui, o calendário do mês rolará sua exibição para o próximo mês ou conjunto de meses.
MCHT_TITLEBTNPREV	O ponto determinado estava sobre o botão no canto superior esquerdo do controle. Se o usuário clicar aqui, o calendário do mês rolará sua exibição para o mês ou conjunto de meses anterior.
MCHT_TITLEMONTH	O ponto determinado estava na barra de título de um mês, com mais de um mês de nome.
MCHT_TITLEYEAR	O ponto determinado estava na barra de título de um mês, ao longo do valor do ano.

st

Tipo: SYSTEMTIME

Recebe informações de data e hora específicas para o local que foi testado com clique.

rc

Tipo: RECT

Local testado por clique.

iOffset

Tipo: int

Ao exibir mais de um calendário, esse é o deslocamento do calendário no ponto testado por clique (baseado em zero).

iRow

Tipo: int

O número da linha da grade de calendário que o ponto de ocorrência determinado tinha acabado. Exemplo: se você testou com clique o 8º de um mês, que está na segunda semana do mês, iRow será um, pois o índice da linha é um índice de linha baseado em zero.

iCol

Tipo: int

O número da coluna para a grade de calendário que o ponto determinado tinha acabado. Por exemplo, se sua semana começar no domingo e o 1º do mês for sexta-feira, o teste de clique em 1º retornará cinco (5) para iCol, já que sexta-feira está na quinta coluna do início da linha, usando um índice de coluna baseado em zero.

Comentários

Colunas e linhas nesse controle usam um sistema de índice baseado em zero, ou seja, a primeira coluna ou linha tem um índice de zero.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h