IXpsOMVisualBrush::GetVisual method (xpsobjectmodel.h)

Artikel
08/28/2023

Mendapatkan penunjuk ke antarmuka visual yang diselesaikan untuk digunakan sebagai sumber kuas.

Sintaks

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

Parameter

[out, retval] visual

Penunjuk ke antarmuka IXpsOMVisual dari objek visual yang diselesaikan yang digunakan sebagai sumber untuk kuas. Jika visual belum diatur, penunjuk NULL dikembalikan.

Nilai yang dikembalikan dalam parameter ini tergantung pada metode mana yang terakhir dipanggil untuk mengatur objek visual.

Metode terbaru yang disebut	Objek yang dikembalikan dalam visual
SetVisualLocal	Visual yang diatur oleh SetVisualLocal.
SetVisualLookup	Visual yang diambil, dengan kunci pencarian yang cocok dengan kunci yang diatur oleh SetVisualLookup, dari direktori sumber daya.
SetVisualLocal maupun SetVisualLookup belum dipanggil.	Penunjuk 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	visual adalah NULL.
XPS_E_LOOKUP_INVALID_TYPE	Nama kunci pencarian yang ditetapkan oleh SetStrokeBrushLookup mereferensikan objek yang bukan kuas.
XPS_E_LOOKUP_NOT_FOUND	Tidak ada objek yang dapat ditemukan dengan nama kunci yang cocok dengan nilai pencarian.

Keterangan

Metode ini mengembalikan penunjuk antarmuka IXpsOMVisual . Namun,
antarmuka yang dikembalikan dapat berupa antarmuka apa pun yang mewarisi dari IXpsOMVisual, seperti IXpsOMCanvas, IXpsOMPath, dan IXpsOMGlyphs.

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