Bagikan melalui

Struktur LVCOLUMNA (commctrl.h)

  • Artikel

Berisi informasi tentang kolom dalam tampilan laporan. Struktur ini digunakan baik untuk membuat dan memanipulasi kolom. Struktur ini menggantikan struktur LV_COLUMN.

Sintaksis

typedef struct tagLVCOLUMNA {
  UINT  mask;
  int   fmt;
  int   cx;
  LPSTR pszText;
  int   cchTextMax;
  int   iSubItem;
  int   iImage;
  int   iOrder;
  int   cxMin;
  int   cxDefault;
  int   cxIdeal;
} LVCOLUMNA, *LPLVCOLUMNA;

Anggota

mask

Jenis: UINT

Variabel yang menentukan anggota mana yang berisi informasi yang valid. Anggota ini bisa nol, atau satu atau beberapa nilai berikut:

Nilai Arti
LVCF_FMT
 Anggota fmt valid.
LVCF_WIDTH
 Anggota cx valid.
LVCF_TEXT
 Anggota pszText valid.
LVCF_SUBITEM
 Anggota iSubItem valid.
LVCF_IMAGE

versi 4.70. Anggota iImage valid.
LVCF_ORDER

versi 4.70. Anggota iOrder valid.
LVCF_MINWIDTH

Versi 6.00 dan Windows Vista.Anggota cxMin valid.
LVCF_DEFAULTWIDTH

Versi 6.00 dan Windows Vista.Anggota cxDefault valid.
LVCF_IDEALWIDTH

Versi 6.00 dan Windows Vista.Anggota cxIdeal valid.

fmt

Jenis: int

Perataan header kolom dan teks subitem di kolom. Perataan kolom paling kiri selalu LVCFMT_LEFT; tidak dapat diubah. Anggota ini bisa menjadi kombinasi dari nilai berikut. Perhatikan bahwa tidak semua kombinasi valid.

Nilai Arti
LVCFMT_LEFT
 Teks rata kiri.
LVCFMT_RIGHT
 Teks rata kanan.
LVCFMT_CENTER
 Teks di tengah.
LVCFMT_JUSTIFYMASK
 Bitmask digunakan untuk memilih bit fmt pembenaran bidang kontrol tersebut. Untuk memeriksa format kolom, gunakan "dan" logis untuk menggabungkan LCFMT_JUSTIFYMASK dengan fmt. Anda kemudian dapat menggunakan pernyataan pengalihan untuk menentukan apakah bit LVCFMT_LEFT, LVCFMT_RIGHT, atau LVCFMT_CENTER diatur.
LVCFMT_IMAGE

versi 4.70. Item menampilkan gambar dari daftar gambar.
LVCFMT_BITMAP_ON_RIGHT

versi 4.70. Bitmap muncul di sebelah kanan teks. Ini tidak memengaruhi gambar dari daftar gambar yang ditetapkan ke item header.
LVCFMT_COL_HAS_IMAGES

versi 4.70. Item header berisi gambar dalam daftar gambar.
LVCFMT_FIXED_WIDTH

Versi 6.00 dan Windows Vista. Tidak dapat mengubah ukuran kolom; sama seperti HDF_FIXEDWIDTH.
LVCFMT_NO_DPI_SCALE

Versi 6.00 dan Windows Vista. Jika tidak diatur, CCM_DPISCALE akan mengatur peningkatan lebar tetap.
LVCFMT_FIXED_RATIO

Versi 6.00 dan Windows Vista. Lebar akan menambah dengan tinggi baris.
LVCFMT_SPLITBUTTON

Versi 6.00 dan Windows Vista. Kolom adalah tombol terpisah (sama dengan HDF_SPLITBUTTON). Header kolom menampilkan tombol pisahkan (sama seperti HDF_SPLITBUTTON).

cx

Jenis: int

Lebar kolom, dalam piksel.

pszText

Jenis: LPTSTR

Jika informasi kolom sedang diatur, anggota ini adalah alamat string yang dihentikan null yang berisi teks header kolom. Jika struktur menerima informasi tentang kolom, anggota ini menentukan alamat buffer yang menerima teks header kolom.

cchTextMax

Jenis: int

Ukuran TCHARbuffer yang ditunjukkan oleh anggota pszText. Jika struktur tidak menerima informasi tentang kolom, anggota ini diabaikan.

iSubItem

Jenis: int

Indeks subitem yang terkait dengan kolom .

iImage

Jenis: int

versi 4.70. Indeks berbasis nol gambar dalam daftar gambar. Gambar yang ditentukan akan muncul di dalam kolom.

iOrder

Jenis: int

versi 4.70. Offset kolom berbasis nol. Offset kolom dalam urutan kiri-ke-kanan. Misalnya, nol menunjukkan kolom paling kiri.

cxMin

Jenis: int

Windows Vista. Lebar minimum kolom dalam piksel.

cxDefault

Jenis: int

Windows Vista. Nilai yang ditentukan aplikasi biasanya digunakan untuk menyimpan lebar default kolom. Anggota ini diabaikan oleh kontrol tampilan daftar.

cxIdeal

Jenis: int

Windows Vista. Baca-saja. Lebar ideal kolom dalam piksel, karena kolom saat ini dapat diotomatiskan ke lebar yang lebih kecil.

Komentar

Jika kolom ditambahkan ke kontrol tampilan daftar dengan indeks 0 (kolom paling kiri), kolom tersebut selalu LVCFMT_LEFT. Mengatur bendera lain pada kolom 0 tidak menimpa perataan tersebut. Oleh karena itu jika Anda terus menyisipkan kolom dengan indeks 0, teks di semua kolom diratakan kiri. Jika Anda ingin kolom pertama rata kanan atau berpusat, Anda bisa membuat kolom dummy, lalu sisipkan satu atau beberapa kolom dengan indeks 1 atau lebih tinggi dan tentukan perataan yang Anda butuhkan. Terakhir hapus kolom dummy.

Nota

Header commctrl.h mendefinisikan LVCOLUMN sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header commctrl.h

Lihat juga

LVM_DELETECOLUMN

LVM_GETCOLUMN

LVM_INSERTCOLUMN

LVM_SETCOLUMN

Referensi