Metode IXpsOMPageReference::SetAdvisoryPageDimensions (xpsobjectmodel.h)

Mengatur dimensi halaman yang disarankan.

Sintaks

HRESULT SetAdvisoryPageDimensions(
  [in] const XPS_SIZE *pageDimensions
);

Parameter

[in] pageDimensions

Dimensi yang disarankan untuk diatur untuk halaman.

Anggota tinggi dan lebar harus memiliki nilai –1,0 atau nilai yang lebih besar dari atau sama dengan +1,0.

Ukuran dijelaskan dalam unit XPS. Ada 96 unit XPS per inci. Misalnya, dimensi halaman 8,5" oleh 11,0" adalah 816 oleh 1.056 unit XPS.

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	PageDimensions adalah NULL atau bidang dalam struktur XPS_SIZE yang direferensikan oleh pageDimensions berisi nilai yang tidak valid.
XPS_E_INVALID_PAGE_SIZE	Ukuran halaman saran yang dijelaskan di pageDimensions tidak valid. Anggota tinggi dan lebarpageDimensions harus memiliki nilai –1,0 atau nilai yang lebih besar dari atau sama dengan +1,0.

Keterangan

Anggota tinggi dan lebar struktur XPS_SIZE yang direferensikan oleh pageDimensions harus memiliki nilai yang lebih besar dari atau sama dengan +1.0, jika nilai bidang tersebut akan diatur, atau –1,0 jika tidak. Misalnya, jika dimensi penasihat diatur hanya untuk lebar halaman, pageDimensions.width akan memiliki nilai yang diinginkan dan pageDimensions.height akan memiliki nilai –1,0.

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

IXpsOMPageReference

Spesifikasi Kertas XML

XPS_SIZE