nn-xpsobjectmodel-ixpsomimagebrush.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NN:xpsobjectmodel.IXpsOMImageBrush	IXpsOMImageBrush (xpsobjectmodel.h)	A brush that uses a raster image as a source.	IXpsOMImageBrush IXpsOMImageBrush interface [XPS Documents and Packaging] IXpsOMImageBrush interface [XPS Documents and Packaging] described xps.ixpsomimagebrush xpsobjectmodel/IXpsOMImageBrush	xps\ixpsomimagebrush.htm	xps	f5478582-466b-496e-b7f3-42fb8caa6814	12/05/2018	IXpsOMImageBrush, IXpsOMImageBrush interface [XPS Documents and Packaging], IXpsOMImageBrush interface [XPS Documents and Packaging],described, xps.ixpsomimagebrush, xpsobjectmodel/IXpsOMImageBrush	xpsobjectmodel.h		Windows	Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps \| UWP apps]	Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps \| UWP apps]					XpsObjectModel.idl								Windows			19H1	IXpsOMImageBrush xpsobjectmodel/IXpsOMImageBrush	c++	APIRef kbSyntax	COM	xpsobjectmodel.h	IXpsOMImageBrush

IXpsOMImageBrush interface

-description

A brush that uses a raster image as a source.

-inheritance

The IXpsOMImageBrush interface inherits from IXpsOMTileBrush. IXpsOMImageBrush also has these types of members:

-remarks

The image used by this brush is defined in a coordinate space that is specified by the image's resolution. The image type must be JPEG, PNG, TIFF 6.0, or HD Photo.

The code example that follows illustrates how to create an instance of this interface.

IXpsOMImageBrush            *newInterface;
// The following values are defined outside of 
// this example.
//  IXpsOMImageResource     *image;
//  XPS_RECT                viewBox;
//  XPS_RECT                viewPort;

// 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->CreateImageBrush (
        image,
        &viewBox,
        &viewPort,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

-see-also

IXpsOMObjectFactory::CreateImageBrush

IXpsOMTileBrush

Interfaces

XML Paper Specification