Metode IXpsOMObjectFactory::CreatePage (xpsobjectmodel.h)

Artikel
03/05/2024

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.

Penting String bahasa harus mengikuti sintaks RFC 3066.

[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
S_OK	Metode berhasil.
E_POINTER	pageDimensions, partUri, atau halaman adalah NULL.
XPS_E_INVALID_LANGUAGE	bahasa tidak berisi string bahasa yang valid.
XPS_E_INVALID_PAGE_SIZE	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

Lihat juga

IXpsOMObjectFactory

Internet Engineering Task Force (IETF) RFC 3066

Spesifikasi Kertas XML

Kesalahan Dokumen XPS

Bagikan melalui