Estrutura MCGRIDINFO (commctrl.h)

  • Artigo

Contém informações sobre parte de um controle de calendário.

Sintaxe

typedef struct tagMCGRIDINFO {
  UINT       cbSize;
  DWORD      dwPart;
  DWORD      dwFlags;
  int        iCalendar;
  int        iRow;
  int        iCol;
  BOOL       bSelected;
  SYSTEMTIME stStart;
  SYSTEMTIME stEnd;
  RECT       rc;
  PWSTR      pszName;
  size_t     cchName;
} MCGRIDINFO, *PMCGRIDINFO;

Membros

cbSize

Tipo: UINT

Tamanho dessa estrutura, em bytes.

dwPart

Tipo: DWORD

A parte do controle de calendário para a qual as informações estão sendo solicitadas. Um dos valores a seguir.

Valor Significado
MCGIP_CALENDARCONTROL
 Todo o controle de calendário, que pode incluir até 12 calendários.
MCGIP_NEXT
 O próximo botão.
MCGIP_PREV
 O botão anterior.
MCGIP_FOOTER
 O rodapé.
MCGIP_CALENDAR
 Um calendário específico. Usado com iCalendar e pszName.
MCGIP_CALENDARHEADER
 Cabeçalho do calendário. Usado com iCalendar e pszName.
MCGIP_CALENDARBODY
 Corpo do calendário. Usado com iCalendar.
MCGIP_CALENDARROW
 Uma determinada linha de calendário. Usado com iCalendar e iRow.
MCGIP_CALENDARCELL
 Uma determinada célula do calendário. Usado com iCalendar, iRow, iCol, bSelected e pszName.

dwFlags

Tipo: DWORD

Indica quais informações devem ser preenchidas. Uma combinação de um ou mais dos valores a seguir.

Valor Significado
MCGIF_DATE
 stStart e stEnd.
MCGIF_RECT
 rc.
MCGIF_NAME
 pszName.

iCalendar

Tipo: int

Se dwPart for MCGIP_CALENDAR, MCGIP_CALENDARHEADER, MCGIP_CALENDARBODY, MCGIP_CALENDARROW ou MCGIP_CALENDARCELL, esse membro especificará o índice do calendário para o qual recuperar informações. Para essas partes, esse deve ser um valor válido, mesmo que haja apenas um calendário que esteja atualmente no controle .

iRow

Tipo: int

Se dwPart for MCGIP_CALENDARROW, especificará a linha para a qual retornar informações.

iCol

Tipo: int

Se dwPart for MCGIP_CALENDARCELL, especificará a coluna da célula para a qual retornar informações. O membro iRow fornece a linha da célula para a qual retornar informações.

bSelected

Tipo: BOOL

Se dwPart for MCGIP_CALENDARCELL, indica se a célula descrita por iRow e iCol está selecionada no momento.

stStart

Tipo: SYSTEMTIME

Retorna a data de início especificada pelo iCalendar. Usado somente quando dwFlags contém MCGIF_DATE.

stEnd

Tipo: SYSTEMTIME

Retorna a data de término especificada pelo iCalendar. Usado somente quando dwFlags contém MCGIF_DATE.

rc

Tipo: RECT

Retorna o retângulo da parte especificada em dwPart. Defina somente se dwFlags contiver MCGIF_RECT.

pszName

Tipo: PWSTR

Ponteiro para uma cadeia de caracteres para a qual cchName é o comprimento. Defina somente se dwFlags contiver MCGIF_NAME e somente para as partes a seguir, conforme descrito no membro dwPart .

  • MCGIP_CALENDAR: retorna o texto das datas selecionadas. No caso de várias seleções, retorna a data no início da seleção.
  • MCGIP_CALENDARCELL: retorna o texto da célula indicada por iRow e iCol, por exemplo, "11" se o 11º dia foi especificado.
  • MCGIP_CALENDARHEADER: retorna o texto do que ele diz no cabeçalho do calendário, por exemplo , "Julho de 2006".

cchName

Tipo: size_t

Comprimento de pszName, em caracteres.

Requisitos

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