ListView_MapIDToIndex makro (commctrl.h)

2024-10-24

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

Sintaksis

UINT ListView_MapIDToIndex(
   HWND hwnd,
   UINT id
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

id

Jenis: UINT

UINT yang berisi ID unik item.

Mengembalikan nilai

Jenis: UINT

Mengembalikan indeks terbaru.

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

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