IXpsOMGeometryFigure interface

Article
06/01/2017

Describes one portion of the path or clipping region that is specified by an IXpsOMGeometry interface.

When to implement

Never. Custom implementation of this interface is not supported.

Members

The IXpsOMGeometryFigure interface inherits from the IUnknown interface. IXpsOMGeometryFigure also has these types of members:

Methods

Methods

The IXpsOMGeometryFigure interface has these methods.

Method	Description
Clone	Makes a deep copy of the interface.
GetIsClosed	Gets a value that indicates whether the figure is closed.
GetIsFilled	Gets a value that indicates whether the figure is filled.
GetOwner	Gets a pointer to the IXpsOMGeometry interface that contains the geometry figure.
GetSegmentCount	Gets the number of segments in the figure.
GetSegmentData	Gets the segment data points for the geometry figure.
GetSegmentDataCount	Gets the number of segment data points in the figure.
GetSegmentStrokePattern	Gets the XPS_SEGMENT_STROKE_PATTERN value that indicates whether the segments in the figure are stroked.
GetSegmentStrokes	Gets stroke definitions for the figure's segments.
GetSegmentTypes	Gets the types of segments in the figure.
GetStartPoint	Gets the starting point of the figure.
SetIsClosed	Sets a value that indicates whether the figure is closed.
SetIsFilled	Sets a value that indicates whether the figure is filled.
SetSegments	Sets the segment information and data points for the segments in the figure.
SetStartPoint	Sets the starting point of the figure.

Remarks

The IXpsOMGeometryFigure corresponds to the PathFigure element in XPS markup.

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

IXpsOMGeometryFigure    *newInterface;
// startPoint contains the starting point
// of the geometry figure being created
XPS_POINT                startPoint = {0,0};

// 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->CreateGeometryFigure (&startPoint, &newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

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

Requirements

Minimum supported client	Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps \| Windows Store apps]
Header	Xpsobjectmodel.h
IDL	XpsObjectModel.idl