Bagikan melalui


IXpsOMDictionary::Metode SetAt (xpsobjectmodel.h)

Menggantikan entri pada lokasi tertentu dalam kamus.

Sintaks

HRESULT SetAt(
  [in] UINT32          index,
  [in] LPCWSTR         key,
  [in] IXpsOMShareable *entry
);

Parameter

[in] index

Indeks berbasis nol dalam kamus tempat entri akan diganti.

[in] key

Kunci yang akan digunakan untuk entri baru.

String yang direferensikan oleh kunci harus unik dalam kamus.

[in] entry

Penunjuk antarmuka IXpsOMShareable yang akan menggantikan konten saat ini 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
S_OK
Metode berhasil.
XPS_E_NO_CUSTOM_OBJECTS
entri tidak menunjuk ke implementasi antarmuka yang dikenali. Implementasi kustom antarmuka XPS Document API tidak didukung.

Keterangan

Pada lokasi yang ditentukan oleh indeks, metode ini merilis antarmuka IXpsOMShareable yang direferensikan oleh penunjuk yang ada, lalu menggantinya dengan penunjuk antarmuka yang diteruskan dalam entri dan menetapkan kunci yang diteruskan dalam kunci.

Pointer antarmuka yang disimpan dalam kamus biasanya akan menunjuk ke antarmuka, seperti IXpsOMBrush dan IXpsOMVisual, yang berasal dari antarmuka IXpsOMShareable . Untuk menentukan jenis antarmuka, panggil metode GetType .

Gambar berikut menggambarkan bagaimana kamus diubah oleh metode SetAt .

Gambar yang memperlihatkan bagaimana RemoveAt menghapus entri dari kamus

Persyaratan

   
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

Kamus IXpsOM

IXpsOMShareable

Spesifikasi Kertas XML

Kesalahan Dokumen XPS