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 |
|---|---|
|
O ponto determinado estava em segundo plano do calendário. |
|
O ponto determinado está fora de qualquer calendário, mas dentro do calendário controla RECT. |
|
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. |
|
O ponto determinado estava acima das datas mínimas no calendário. |
|
O ponto determinado estava acima das datas máximas no calendário. |
|
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. |
|
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. |
|
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. |
|
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. |
|
O ponto determinado não estava no controle de calendário do mês ou estava em uma parte inativa do controle. |
|
O ponto determinado foi sobre o fundo do título de um mês. |
|
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. |
|
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. |
|
O ponto determinado estava na barra de título de um mês, com mais de um mês de nome. |
|
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 |