Struktur LVGROUP (commctrl.h)

  • Artikel

Digunakan untuk mengatur dan mengambil grup.

Sintaks

typedef struct tagLVGROUP {
  UINT   cbSize;
  UINT   mask;
  LPWSTR pszHeader;
  int    cchHeader;
  LPWSTR pszFooter;
  int    cchFooter;
  int    iGroupId;
  UINT   stateMask;
  UINT   state;
  UINT   uAlign;
  LPWSTR pszSubtitle;
  UINT   cchSubtitle;
  LPWSTR pszTask;
  UINT   cchTask;
  LPWSTR pszDescriptionTop;
  UINT   cchDescriptionTop;
  LPWSTR pszDescriptionBottom;
  UINT   cchDescriptionBottom;
  int    iTitleImage;
  int    iExtendedImage;
  int    iFirstItem;
  UINT   cItems;
  LPWSTR pszSubsetTitle;
  UINT   cchSubsetTitle;
} LVGROUP, *PLVGROUP;

Anggota

cbSize

Jenis: UINT

Ukuran struktur ini, dalam byte.

mask

Jenis: UINT

Masker yang menentukan anggota struktur mana yang merupakan input yang valid. Satu atau beberapa nilai berikut ini:

Nilai Makna
LVGF_NONE
 Tidak ada item lain yang valid.
LVGF_HEADER
 Anggota pszHeader dan cchHeader valid.
LVGF_FOOTER
 Anggota pszFooter dan cchFooter valid.
LVGF_STATE
 anggota statedan stateMask valid.
LVGF_ALIGN
 Anggota uAlign valid.
LVGF_GROUPID
 Anggota iGroupId valid.
LVGF_SUBTITLE

Versi 6.00 dan yang lebih baru. Anggota pszSubtitle valid.
LVGF_TASK

Versi 6.00 dan yang lebih baru. Anggota pszTask valid.
LVGF_DESCRIPTIONTOP

Versi 6.00 dan yang lebih baru. Anggota pszDescriptionTop valid.
LVGF_DESCRIPTIONBOTTOM

Versi 6.00 dan yang lebih baru. Anggota pszDescriptionBottom valid.
LVGF_TITLEIMAGE

Versi 6.00 dan yang lebih baru. Anggota iTitleImage valid.
LVGF_EXTENDEDIMAGE

Versi 6.00 dan yang lebih baru. Anggota iExtendedImage valid.
LVGF_ITEMS

Versi 6.00 dan yang lebih baru. Anggota cItems valid.
LVGF_SUBSET

Versi 6.00 dan yang lebih baru. Anggota pszSubsetTitle valid.
LVGF_SUBSETITEMS

Versi 6.00 dan yang lebih baru. Anggota cchSubsetTitle valid.

pszHeader

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks header saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks header.

cchHeader

Jenis: int

Ukuran dalam TCHARdari buffer yang diarahkan oleh anggota pszHeader . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

pszFooter

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks footer saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks footer.

cchFooter

Jenis: int

Ukuran dalam TCHARdari buffer yang diacu oleh anggota pszFooter . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

iGroupId

Jenis: int

ID grup.

stateMask

Jenis: UINT

Masker yang digunakan dengan LVM_GETGROUPINFO dan LVM_SETGROUPINFO untuk menentukan bendera mana dalam nilai status yang sedang diambil atau diatur.

state

Jenis: UINT

Bendera yang bisa memiliki salah satu nilai berikut:

Nilai Makna
LVGS_NORMAL
 Grup diperluas, nama grup ditampilkan, dan semua item dalam grup ditampilkan.
LVGS_COLLAPSED
 Grup diciutkan.
LVGS_HIDDEN
 Grup disembunyikan.
LVGS_NOHEADER

Versi 6.00 dan yang lebih baru. Grup tidak menampilkan header.
LVGS_COLLAPSIBLE

Versi 6.00 dan yang lebih baru. Grup dapat diciutkan.
LVGS_FOCUSED

Versi 6.00 dan yang lebih baru. Grup memiliki fokus keyboard.
LVGS_SELECTED

Versi 6.00 dan yang lebih baru. Grup dipilih.
LVGS_SUBSETED

Versi 6.00 dan yang lebih baru. Grup hanya menampilkan sebagian dari itemnya.
LVGS_SUBSETLINKFOCUSED

Versi 6.00 dan yang lebih baru. Tautan subset grup memiliki fokus keyboard.

uAlign

Jenis: UINT

Menunjukkan perataan teks header atau footer untuk grup. Ini bisa memiliki satu atau beberapa nilai berikut. Gunakan salah satu bendera header. Bendera footer bersifat opsional.

Nilai Makna
LVGA_FOOTER_CENTER
 Teks footer dipusatkan secara horizontal di jendela.
LVGA_FOOTER_LEFT
 Teks footer diratakan di sebelah kiri jendela.
LVGA_FOOTER_RIGHT
 Teks footer diratakan di sebelah kanan jendela.
LVGA_HEADER_CENTER
 Teks header dipusatkan secara horizontal di jendela.
LVGA_HEADER_LEFT
 Teks header diratakan di sebelah kiri jendela.
LVGA_HEADER_RIGHT
 Teks header diratakan di sebelah kanan jendela.

pszSubtitle

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks subtitel saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks subtitel. Elemen ini digambar di bawah teks header.

cchSubtitle

Jenis: UINT

Ukuran, dalam TCHARs, dari buffer yang diacu oleh anggota pszSubtitle . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

pszTask

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks untuk tautan tugas saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks tugas. Item ini digambar rata kanan berlawanan dengan teks header. Saat diklik oleh pengguna, tautan tugas menghasilkan pemberitahuan LVN_LINKCLICK .

cchTask

Jenis: UINT

Ukuran dalam TCHARdari buffer yang diacu oleh anggota pszTask . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

pszDescriptionTop

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks deskripsi teratas saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks deskripsi teratas. Item ini digambar berlawanan dengan gambar judul ketika ada gambar judul, tidak ada gambar yang diperluas, dan uAlign==LVGA_HEADER_CENTER.

cchDescriptionTop

Jenis: UINT

Ukuran dalam TCHARdari buffer yang diarahkan oleh anggota pszDescriptionTop . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

pszDescriptionBottom

Jenis: LPWSTR

Penunjuk ke string yang dihentikan null yang berisi teks deskripsi bawah saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks deskripsi bawah. Item ini digambar di bawah teks deskripsi teratas ketika ada gambar judul, tidak ada gambar yang diperluas, dan uAlign==LVGA_HEADER_CENTER.

cchDescriptionBottom

Jenis: UINT

Ukuran dalam TCHARdari buffer yang diarahkan oleh anggota pszDescriptionBottom . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

iTitleImage

Jenis: int

Indeks gambar judul dalam daftar gambar kontrol.

iExtendedImage

Jenis: int

Indeks gambar yang diperluas dalam daftar gambar kontrol.

iFirstItem

Jenis: int

Baca-saja.

cItems

Jenis: UINT

Baca-saja dalam mode data non-pemilik.

pszSubsetTitle

Jenis: LPWSTR

NULL jika grup bukan subset. Penunjuk ke string yang dihentikan null yang berisi teks judul subset saat informasi item sedang diatur. Jika informasi grup sedang diambil, anggota ini menentukan alamat buffer yang menerima teks judul subset.

cchSubsetTitle

Jenis: UINT

Ukuran dalam TCHARdari buffer yang diacu oleh anggota pszSubsetTitle . Jika struktur tidak menerima informasi tentang grup, anggota ini diabaikan.

Keterangan

Semua string yang dikembalikan dalam struktur ini harus diperlakukan sebagai baca-saja.

Pembuatan subset saat ini tidak didukung, dan pszSubsetTitle tidak dapat diatur oleh aplikasi.

Persyaratan

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