ListView_MapIDToIndex makro (commctrl.h)

Artikel
08/22/2023

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

Sintaks

void ListView_MapIDToIndex(
   hwnd,
   id
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

id

Jenis: UINT

UINT yang berisi ID unik item.

Mengembalikan 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 ketika Anda membuat item. Anda menggunakan ID ini untuk menjamin keunikan selama adanya kontrol tampilan daftar.

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

Jika Anda perlu mengetahui indeks item setelah membuat ID, panggil LVM_MAPIDTOINDEX dengan ID unik dan mengembalikan indeks terbaru.

Catatan Di 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_MapIDToIndex, tentukan Comctl32.dll versi 6 dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan

Persyaratan	Nilai
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