Metode IXpsOMGradientStop::SetColor (xpsobjectmodel.h)

Artikel
03/05/2024

Mengatur nilai warna dan profil warna pemberhentian gradien.

Sintaks

HRESULT SetColor(
  [in] const XPS_COLOR            *color,
  [in] IXpsOMColorProfileResource *colorProfile
);

Parameter

[in] color

Nilai warna yang akan diatur pada pemberhentian gradien.

Jika nilai bidang colorType dalam struktur XPS_COLOR yang diteruskan dalam parameter ini XPS_COLOR_TYPE_CONTEXT, profil warna yang valid harus disediakan dalam parameter colorProfile .

[in] colorProfile

Profil warna yang akan digunakan dengan warna.

Profil warna diperlukan saat nilai bidang colorType dalam struktur XPS_COLOR yang diteruskan dalam parameter warnaXPS_COLOR_TYPE_CONTEXT. Jika nilai bidang colorType tidak XPS_COLOR_TYPE_CONTEXT, parameter ini harus diatur ke NULL.

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.
E_POINTER	warna adalah NULL.
XPS_E_MISSING_COLORPROFILE	colorProfile adalah NULL ketika profil warna diharapkan. Profil warna diperlukan saat jenis warna XPS_COLOR_TYPE_CONTEXT.
XPS_E_NO_CUSTOM_OBJECTS	colorProfile tidak menunjuk ke implementasi antarmuka yang dikenali. Implementasi kustom antarmuka XPS Document API tidak didukung.
XPS_E_UNEXPECTED_COLORPROFILE	colorProfile berisi profil warna ketika tidak diharapkan. Profil warna hanya diperbolehkan saat jenis warna XPS_COLOR_TYPE_CONTEXT.

Keterangan

Profil warna hanya diperlukan saat jenis warna warnaXPS_COLOR_TYPE_CONTEXT.

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

IXpsOMColorProfileResource

IXpsOMGradientStop

Spesifikasi Kertas XML

Kesalahan Dokumen XPS

XPS_COLOR

Bagikan melalui