DPA_SortedInsertPtr makro (dpa_dsa.h)

Artikel
10/24/2024

Sisipkan item baru sebelum atau sesudah item yang sudah ditentukan.

Sintaksis

int DPA_SortedInsertPtr(
   HDPA          hdpa,
   void          *pFind,
   int           iStart,
   PFNDPACOMPARE pfnCompare,
   LPARAM        lParam,
   UINT          options,
   void          *pitem
);

Parameter

hdpa

Jenis: HDPA

Handel ke DPA.

pFind

Jenis: batal*

Penunjuk item yang digunakan untuk menentukan titik penyisipan untuk item baru (lihat Keterangan).

iStart

Jenis: int

Indeks di DPA tempat mulai mencari pFind.

pfnCompare

Jenis: PFNDPACOMPARE

Penunjuk ke fungsi perbandingan. Lihat PFNDPACOMPARE atau PFNDPACOMPARECONST untuk prototipe fungsi perbandingan.

lParam

Jenis: LPARAM

Parameter tambahan yang digunakan untuk meneruskan informasi ke fungsi perbandingan yang diarahkan oleh pfnCompare.

options

Jenis: UINT

Titik penyisipan. Harus salah satu nilai berikut.

Nilai	Arti
DPAS_INSERTBEFORE	Sisipkan item baru sebelum item pFind.
DPAS_INSERTAFTER	Sisipkan item baru setelah item pFind .

pitem

Jenis: batal*

Penunjuk ke item yang akan disisipkan.

Mengembalikan nilai

Jenis: int

Mengembalikan indeks item baru, atau -1 jika tindakan sisipkan gagal.

Komentar

Catatan Makro ini membungkus fungsi DPA_InsertPtr dan DPA_Search.

Bendera DPAS_SORTED disertakan dalam opsi secara default untuk menunjukkan bahwa DPA diurutkan.

Lihat DPA_Search fungsi untuk informasi tambahan tentang bagaimana item pFind berada. Item baru disisipkan sebelum atau sesudah item pFind sesuai dengan opsi parameter . Parameter pFind tidak perlu ada di DPA. Jika tidak ada di DPA, maka item baru disisipkan di mana pFind akan dimasukkan ke dalam DPA dalam urutan yang diurutkan.

Persyaratan

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

Bagikan melalui