ListView_MapIndexToID makro (commctrl.h)

Artikel
08/22/2023

Memetakan indeks item ke ID unik. Anda dapat menggunakan makro ini atau mengirim pesan LVM_MAPINDEXTOID secara eksplisit.

Sintaks

void ListView_MapIndexToID(
   hwnd,
   index
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

index

Jenis: UINT

UINT yang berisi indeks item.

Menampilkan nilai

Tidak ada

Keterangan

Kontrol tampilan daftar melacak item secara internal menurut indeks. Ini dapat menyebabkan masalah karena indeks dapat berubah selama keberadaan kontrol.

Anda bisa menggunakan makro ini untuk menandai item dengan ID saat Anda membuat item. Anda menggunakan ID ini untuk menjamin keunikan selama keberadaan kontrol tampilan daftar.

Untuk mengidentifikasi item secara unik, ambil indeks yang dikembalikan dari panggilan seperti IComponent::GetDisplayInfo dan panggil LVM_MAPINDEXTOID. Nilai yang dikembalikan adalah ID unik.

Catatan Dalam lingkungan multithreaded, Anda hanya dapat memastikan indeks yang benar dikembalikan pada utas yang menghosting kontrol tampilan daftar, bukan pada utas latar belakang.

Untuk menggunakan ListView_MapIndexToID, tentukan Comctl32.dll versi 6 dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan


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

Bagikan melalui