IXpsOMDictionary::Metode InsertAt (xpsobjectmodel.h)
Menyisipkan antarmuka IXpsOMShareable pada lokasi tertentu dalam kamus dan mengatur kunci untuk mengidentifikasi antarmuka.
Sintaks
HRESULT InsertAt(
[in] UINT32 index,
[in] LPCWSTR key,
[in] IXpsOMShareable *entry
);
Parameter
[in] index
Indeks berbasis nol dalam kamus tempat antarmuka IXpsOMShareable akan disisipkan.
[in] key
Kunci yang akan digunakan untuk mengidentifikasi antarmuka IXpsOMShareable dalam kamus.
String yang direferensikan oleh kunci harus unik dalam kamus.
[in] entry
Penunjuk antarmuka IXpsOMShareable yang akan dimasukkan di lokasi yang ditentukan oleh indeks.
Kamus tidak boleh berisi penunjuk antarmuka duplikat. Parameter ini harus berisi penunjuk antarmuka yang belum ada dalam kamus.
Nilai kembali
Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk informasi tentang nilai pengembalian API dokumen XPS yang tidak tercantum dalam tabel ini, lihat Kesalahan Dokumen XPS.
Menampilkan kode | Deskripsi |
---|---|
|
Metode berhasil. |
|
entri tidak menunjuk ke implementasi antarmuka yang dikenali. Implementasi kustom antarmuka XPS Document API tidak didukung. |
Keterangan
Pointer antarmuka yang disimpan dalam kamus biasanya akan menjadi pointer ke antarmuka, seperti IXpsOMBrush dan IXpsOMVisual, yang berasal dari antarmuka IXpsOMShareable . Untuk menentukan jenis antarmuka, panggil metode IXpsOMShareable::GetType .
Di lokasi yang ditentukan oleh indeks, metode ini menyisipkan penunjuk antarmuka IXpsOMShareable dan mengatur kunci; pointer antarmuka dan kunci masing-masing diteruskan dalam nilai dan kunci. Sebelum nilai dan kunci disisipkan, penunjuk antarmuka dan kunci pada ini dan semua lokasi berikutnya dipindahkan ke atas oleh satu indeks.
Gambar yang mengikuti menggambarkan bagaimana kamus diubah oleh metode InsertAt .
![Gambar yang memperlihatkan bagaimana InsertAt menambahkan entri ke kamus](images/dictionary_insertat.png)
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | xpsobjectmodel.h |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk