Bagikan melalui

Struktur MCGRIDINFO (commctrl.h)

  • Artikel

Berisi informasi tentang bagian dari kontrol kalender.

Sintaks

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;

Anggota

cbSize

Jenis: UINT

Ukuran struktur ini, dalam byte.

dwPart

Jenis: DWORD

Bagian dari kontrol kalender yang informasinya diminta. Salah satu nilai berikut.

Nilai Makna
MCGIP_CALENDARCONTROL
 Seluruh kontrol kalender, yang mungkin mencakup hingga 12 kalender.
MCGIP_NEXT
 Tombol berikutnya.
MCGIP_PREV
 Tombol sebelumnya.
MCGIP_FOOTER
 Catatan kakinya.
MCGIP_CALENDAR
 Satu kalender tertentu. Digunakan dengan iCalendar dan pszName.
MCGIP_CALENDARHEADER
 Header kalender. Digunakan dengan iCalendar dan pszName.
MCGIP_CALENDARBODY
 Isi kalender. Digunakan dengan iCalendar.
MCGIP_CALENDARROW
 Baris kalender tertentu. Digunakan dengan iCalendar dan iRow.
MCGIP_CALENDARCELL
 Sel kalender tertentu. Digunakan dengan iCalendar, iRow, iCol, bSelected dan pszName.

dwFlags

Jenis: DWORD

Menunjukkan informasi apa yang akan diisi. Kombinasi satu atau beberapa nilai berikut ini.

Nilai Makna
MCGIF_DATE
 stStart dan stEnd.
MCGIF_RECT
 Busur.
MCGIF_NAME
 pszName.

iCalendar

Jenis: int

Jika dwPart MCGIP_CALENDAR, MCGIP_CALENDARHEADER, MCGIP_CALENDARBODY, MCGIP_CALENDARROW, atau MCGIP_CALENDARCELL, anggota ini menentukan indeks kalender untuk mengambil informasi. Untuk bagian-bagian tersebut, ini harus menjadi nilai yang valid meskipun hanya ada satu kalender yang saat ini berada dalam kontrol.

iRow

Jenis: int

Jika dwPart MCGIP_CALENDARROW, menentukan baris yang akan mengembalikan informasi.

iCol

Jenis: int

Jika dwPart MCGIP_CALENDARCELL, menentukan kolom sel untuk mengembalikan informasi. Anggota iRow menyediakan baris sel untuk mengembalikan informasi.

bSelected

Jenis: BOOL

Jika dwPart MCGIP_CALENDARCELL, menunjukkan apakah sel yang dijelaskan oleh iRow dan iCol saat ini dipilih.

stStart

Jenis: SYSTEMTIME

Mengembalikan tanggal mulai yang ditentukan oleh iCalendar. Hanya digunakan ketika dwFlags berisi MCGIF_DATE.

stEnd

Jenis: SYSTEMTIME

Mengembalikan tanggal akhir yang ditentukan oleh iCalendar. Hanya digunakan ketika dwFlags berisi MCGIF_DATE.

rc

Jenis: RECT

Mengembalikan persegi panjang bagian yang ditentukan dalam dwPart. Atur hanya jika dwFlags berisi MCGIF_RECT.

pszName

Jenis: PWSTR

Penunjuk ke string yang panjangnya adalah cchName . Atur hanya jika dwFlags berisi MCGIF_NAME, dan hanya untuk bagian berikut, seperti yang dijelaskan dalam anggota dwPart .

  • MCGIP_CALENDAR: Mengembalikan teks dari tanggal yang dipilih. Dalam kasus beberapa pilihan, mengembalikan tanggal di awal pilihan.
  • MCGIP_CALENDARCELL: Mengembalikan teks sel yang ditunjukkan oleh iRow dan iCol, misalnya "11" jika hari ke-11 ditentukan.
  • MCGIP_CALENDARHEADER: Mengembalikan teks dari apa yang dikatakannya di header kalender, misalnya "Juli, 2006".

cchName

Jenis: size_t

Panjang pszName, dalam karakter.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header commctrl.h