ListView_MapIndexToID makro (commctrl.h)

2024-10-24

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

Sintaksis

UINT ListView_MapIndexToID(
   HWND hwnd,
   UINT index
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

index

Jenis: UINT

UINT yang berisi indeks item.

Mengembalikan nilai

Jenis: UINT

Mengembalikan ID unik.

Komentar

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

Anda dapat menggunakan makro ini untuk menandai item dengan ID saat 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 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_MapIndexToID, tentukan Comctl32.dll versi 6 dalam manifes. Untuk informasi selengkapnya tentang manifes, lihat Mengaktifkan Gaya Visual.

Persyaratan

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

Bagikan melalui