CMonthCalCtrl::GetCalendarGridInfo

Artigo
08/25/2010

Recupera informações sobre o controle de calendário do mês corrente.

BOOL GetCalendarGridInfo(
          PMCGRIDINFO pmcGridInfo
) const;

Parâmetros

Parâmetro	Descrição
[out] pmcGridInfo	Ponteiro para um MCGRIDINFOestrutura de recebe informações sobre o controle de calendário do mês corrente.O chamador é responsável por alocar e inicializar essa estrutura.

Valor de retorno

true Se esse método for bem-sucedida; caso contrário, false.

Comentários

Esse método envia o MCM_GETCALENDARGRIDINFO mensagem, que é descrita no Windows SDK.

Requisitos

Cabeçalho: afxdtctl.h

Este controle é suportado no Windows Vista e mais recente.

Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define a variável, m_monthCalCtrl, que é usado para acessar programaticamente o controle de calendário mensal. Essa variável é usada no exemplo a seguir.

 // Variable used to reference the month calendar control.
    CMonthCalCtrl m_monthCalCtrl;
    // Variable used to reference the splitbutton control.
    CSplitButton m_splitButton;

O exemplo de código a seguir usa o GetCalendarGridInfo método para recuperar a data do calendário que exibe o controle de calendário do mês corrente.

  WCHAR name[26];
    name[0] = _T('\0');
    MCGRIDINFO gridInfo;
    gridInfo.cbSize = sizeof(MCGRIDINFO);
    gridInfo.dwPart = MCGIP_CALENDARHEADER;
    gridInfo.dwFlags = MCGIF_NAME;
    gridInfo.iCalendar = 0;
    gridInfo.pszName = reinterpret_cast<PWSTR>(&name);
    gridInfo.cchName = sizeof(name);

    m_monthCalCtrl.GetCalendarGridInfo( &gridInfo );

    CString str;
    CString calendarDate(name);
    str.Format(_T("Calendar date: '%s'"), calendarDate);
    AfxMessageBox(str, MB_ICONINFORMATION);