IXpsOMObjectFactory::CreateVisualBrush method (xpsobjectmodel.h)
Membuat antarmuka IXpsOMVisualBrush , yang merupakan IXpsOMTileBrush yang menggunakan objek visual.
Sintaks
HRESULT CreateVisualBrush(
[in] const XPS_RECT *viewBox,
[in] const XPS_RECT *viewPort,
[out, retval] IXpsOMVisualBrush **visualBrush
);
Parameter
[in] viewBox
Struktur XPS_RECT yang menentukan area gambar sumber yang akan digunakan dalam kuas. Parameter ini tidak boleh NULL.
[in] viewPort
Struktur XPS_RECT yang menentukan area geometri tujuan petak peta. Parameter ini tidak boleh NULL.
[out, retval] visualBrush
Penunjuk ke antarmuka IXpsOMVisualBrush 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. |
|
viewBox, viewPort, atau visualBrush adalah NULL. |
|
viewBox atau viewPort berisi persegi panjang atau nilai yang tidak valid. |
Keterangan
Contoh kode yang mengikuti menggambarkan bagaimana metode ini digunakan untuk membuat antarmuka baru.
IXpsOMVisualBrush *newInterface;
// 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->CreateVisualBrush (
&viewBox,
&viewPort,
&newInterface);
if (SUCCEEDED(hr))
{
// assign visual using one of the following:
newInterface->SetVisualLocal (localVisual);
// or
newInterface->SetVisualLookup (visualLookupKey);
// use newInterface
newInterface->Release();
}
xpsFactory->Release();
}
else
{
// evaluate HRESULT error returned in hr
}
// use newInterface
newInterface->Release();
xpsFactory->Release();
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 |