Struktur LVBKIMAGEA (commctrl.h)

  • Artikel

Berisi informasi tentang gambar latar belakang kontrol tampilan daftar. Struktur ini digunakan untuk mengatur dan mengambil informasi gambar latar belakang.

Sintaks

typedef struct tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

Anggota

ulFlags

Jenis: ULONG

Anggota ini mungkin satu atau beberapa bendera berikut. Anda dapat menggunakan nilai LVBKIF_SOURCE_MASK untuk menutupi semua kecuali bendera sumber. Anda dapat menggunakan nilai LVBKIF_STYLE_MASK untuk menutupi semua kecuali bendera gaya.

Nilai Makna
LVBKIF_SOURCE_NONE
 Kontrol tampilan daftar tidak memiliki gambar latar belakang.
LVBKIF_SOURCE_HBITMAP
 Bitmap latar belakang disediakan melalui anggota hbmLVBKIMAGE. Jika pesan LVM_SETBKIMAGE berhasil, tampilan daftar mengambil kepemilikan bitmap.
LVBKIF_SOURCE_URL
 Anggota pszImage berisi URL gambar latar belakang.
LVBKIF_STYLE_NORMAL
 Gambar latar belakang ditampilkan secara normal.
LVBKIF_STYLE_TILE
 Gambar latar belakang akan diurutkan untuk mengisi seluruh latar belakang kontrol.
LVBKIF_FLAG_TILEOFFSET
 Tentukan koordinat petak peta pertama. Bendera ini hanya valid jika bendera LVBKIF_STYLE_TILE juga ditentukan. Jika bendera ini tidak ditentukan, petak peta pertama dimulai di sudut kiri atas area klien. Jika Anda menggunakan ComCtl32.dll Versi 6.0 bidang xOffsetPercent dan yOffsetPercent berisi piksel, bukan nilai persentase, untuk menentukan koordinat petak peta pertama. Comctl32.dll versi 6 tidak dapat didistribusikan ulang tetapi disertakan dalam Windows atau yang lebih baru. Selain itu, Anda harus menentukan Comctl32.dll versi 6 dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.
LVBKIF_TYPE_WATERMARK
 Bitmap latar belakang marka air disediakan melalui anggota hbmLVBKIMAGE. Jika pesan LVM_SETBKIMAGE berhasil, kontrol tampilan daftar mengambil kepemilikan bitmap.
LVBKIF_FLAG_ALPHABLEND
 Hanya berlaku saat LVBKIF_TYPE_WATERMARK juga ditentukan. Bendera ini menunjukkan bitmap yang disediakan melalui LVBKIF_TYPE_WATERMARK berisi saluran alfa yang valid.

hbm

Jenis: HBITMAP

Handel bitmap latar belakang. Anggota ini hanya berlaku jika bendera LVBKIF_SOURCE_HBITMAP diatur dalam ulFlags.

pszImage

Jenis: LPTSTR

Alamat string yang dihentikan NULL yang berisi URL gambar latar belakang. Anggota ini hanya berlaku jika bendera LVBKIF_SOURCE_URL diatur dalam ulFlags. Anggota ini harus diinisialisasi untuk menunjuk ke buffer yang berisi atau menerima teks sebelum mengirim pesan.

cchImageMax

Jenis: UINT

Ukuran buffer di alamat di pszImage. Jika informasi dikirim ke kontrol, anggota ini diabaikan.

xOffsetPercent

Jenis: int

Persentase area klien kontrol yang harus diimbangi gambar secara horizontal. Misalnya, pada 0 persen, gambar akan ditampilkan di tepi kiri area klien kontrol. Pada 50 persen, gambar akan ditampilkan secara horizontal berpusat di area klien kontrol. Pada 100 persen, gambar akan ditampilkan di tepi kanan area klien kontrol. Anggota ini hanya berlaku ketika LVBKIF_STYLE_NORMAL ditentukan dalam ulFlags. Jika LVBKIF_FLAG_TILEOFFSET dan LVBKIF_STYLE_TILE ditentukan dalam ulFlags, maka nilai menentukan piksel, bukan offset persentase, dari petak peta pertama. Jika tidak, nilai diabaikan.

yOffsetPercent

Jenis: int

Persentase area klien kontrol yang harus diimbangi gambar secara vertikal. Misalnya, pada 0 persen, gambar akan ditampilkan di tepi atas area klien kontrol. Pada 50 persen, gambar akan ditampilkan secara vertikal berpusat di area klien kontrol. Pada 100 persen, gambar akan ditampilkan di tepi bawah area klien kontrol. Anggota ini hanya berlaku ketika LVBKIF_STYLE_NORMAL ditentukan dalam ulFlags. Jika LVBKIF_FLAG_TILEOFFSET dan LVBKIF_STYLE_TILE ditentukan dalam ulFlags, maka nilai menentukan piksel, bukan offset persentase, dari petak peta pertama. Jika tidak, nilai diabaikan.

Keterangan

Struktur ini digunakan dengan pesan LVM_GETBKIMAGE dan LVM_SETBKIMAGE .

Catatan

Header commctrl.h mendefinisikan LVBKIMAGE sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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

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