Bagikan melalui


Metode IXpsOMTileBrush::GetViewbox (xpsobjectmodel.h)

Mendapatkan bagian gambar sumber yang akan digunakan oleh petak peta.

Sintaks

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

Parameter

[out, retval] viewbox

Struktur XPS_RECT yang menjelaskan area konten sumber yang akan digunakan oleh petak peta.

Nilai kembali

Jika metode berhasil, metode akan mengembalikan S_OK; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
E_POINTER
viewbox adalah NULL.

Keterangan

Kotak tampilan kuas menentukan bagian gambar sumber atau visual yang akan digunakan sebagai gambar petak peta.

Koordinat kotak tampilan kuas relatif terhadap konten sumber, sehingga (0,0) menentukan sudut kiri atas konten sumber. Untuk gambar, dimensi yang ditentukan oleh kotak tampilan kuas dinyatakan dalam unit 1/96". Koordinat piksel yang sesuai dalam gambar sumber dihitung sebagai berikut:

Dalam ilustrasi yang mengikuti, gambar di sebelah kiri adalah contoh gambar sumber, gambar di tengah menunjukkan kotak tampilan yang dipilih, dan gambar di sebelah kanan menunjukkan kuas yang dihasilkan.

Ilustrasi yang memperlihatkan contoh kotak tampilan Jika resolusi gambar sumber adalah 96 sebesar 96 titik per inci dan dimensi gambar adalah 96 x 96 piksel, nilai bidang dalam parameter kotak tampilan adalah:

Nilai parameter sebelumnya sesuai dengan gambar sumber sebagai:

SourceLeft = 96 × 48 / 96 = 48 piksel dari sisi kiri
SourceTop = 96 × 4 / 96 = 24 piksel dari atas
SourceWidth = 96 × lebar 24 / 96 = 24 piksel
SourceHeight = 96 × 48 / 96 = tinggi 48 piksel

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

IXpsOMTileBrush

Spesifikasi Kertas XML

XPS_RECT