Metode IXpsOMObjectFactory::CreatePage (xpsobjectmodel.h)
Membuat antarmuka IXpsOMPage , yang menyediakan simpul akar pohon objek yang mewakili konten satu halaman.
Sintaks
HRESULT CreatePage(
[in] const XPS_SIZE *pageDimensions,
[in] LPCWSTR language,
[in] IOpcPartUri *partUri,
[out, retval] IXpsOMPage **page
);
Parameter
[in] pageDimensions
Struktur XPS_SIZE yang menentukan ukuran halaman yang akan dibuat.
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.
[in] language
String yang menunjukkan bahasa default halaman yang dibuat.
[in] partUri
Antarmuka IOpcPartUri yang berisi nama bagian yang akan ditetapkan ke sumber daya ini.
[out, retval] page
Penunjuk ke antarmuka IXpsOMPage baru.
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 |
---|---|
|
Metode berhasil. |
|
pageDimensions, partUri, atau halaman adalah NULL. |
|
bahasa tidak berisi string bahasa yang valid. |
|
pageDimensions berisi ukuran halaman yang tidak valid atau nilai ukuran halaman yang tidak valid. |
Keterangan
Contoh kode yang mengikuti menggambarkan bagaimana metode ini digunakan untuk membuat antarmuka baru.
IXpsOMPage *newInterface;
// The following values are defined outside of
// this example.
// LPWSTR language;
// XPS_SIZE pageDimensions;
// Note the implicit requirement that CoInitializeEx
// has previously been called from this thread.
hr = CoCreateInstance(
__uuidof(XpsOMObjectFactory),
NULL,
CLSCTX_INPROC_SERVER,
_uuidof(IXpsOMObjectFactory),
reinterpret_cast<LPVOID*>(&xpsFactory)
);
if (SUCCEEDED(hr))
{
hr = xpsFactory->CreatePartUri(partUriString, &partUri);
if (SUCCEEDED(hr))
{
hr = xpsFactory->CreatePage (
&pageDimensions,
language,
partUri,
&newInterface);
if (SUCCEEDED(hr))
{
// use newInterface
newInterface->Release();
}
partUri->Release();
}
xpsFactory->Release();
}
else
{
// evaluate HRESULT error returned in hr
}
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 |