Compartilhar via


MonthCal_SetDayState macro (commctrl.h)

Define os estados de dia para todos os meses que estão visíveis no momento dentro de um controle de calendário mensal. Você pode usar essa macro ou enviar a mensagem MCM_SETDAYSTATE explicitamente.

Sintaxe

BOOL MonthCal_SetDayState(
   HWND            hmc,
   INT             cbds,
   LPMONTHDAYSTATE rgds
);

Parâmetros

hmc

Tipo: HWND

Manipule para um controle de calendário de um mês.

cbds

Tipo: INT

Valor do tipo int indicando quantos elementos estão na matriz à qual rgds aponta.

rgds

Tipo: LPMONTHDAYSTATE

Ponteiro para uma matriz de valores MONTHDAYSTATE que definem como o controle de calendário do mês será desenhado todos os dias em sua exibição.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero de outra forma.

Observações

Um aplicativo pode definir explicitamente as informações de estado do dia usando essa macro, mas o estado não persistirá quando uma parte diferente do calendário for rolada para exibição. As informações de estado do dia geralmente são definidas em resposta ao código de notificação MCN_GETDAYSTATE, que é enviado sempre que o controle precisa ser atualizado.

A matriz em rgds deve conter tantos elementos quanto o valor retornado pela macro a seguir:

MonthCal_GetMonthRange(hmc, GMR_DAYSTATE, NULL);

A macro anterior retorna o número total de meses que estão em exibição completa ou parcial na exibição do calendário do mês.

Tenha em mente que a matriz em rgds deve conter VALORES MONTHDAYSTATE que correspondem a todos os meses atualmente na exibição do controle, em ordem cronológica. Isso inclui os dois meses que podem ser parcialmente exibidos antes do primeiro mês e após o último mês.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h

Consulte também

usando controles de calendário de mês