Share via


XPS_SPREAD_METHOD enumeration

Describes how the spread region is to be filled. The spread region is the area that falls within the drawing area but outside of the gradient region.

Syntax

typedef enum  { 
  XPS_SPREAD_METHOD_PAD      = 1,
  XPS_SPREAD_METHOD_REFLECT,
  XPS_SPREAD_METHOD_REPEAT
} XPS_SPREAD_METHOD;

Constants

  • XPS_SPREAD_METHOD_PAD
    The spread region is filled with the color whose value equals the color at the end of the gradient region.

  • XPS_SPREAD_METHOD_REFLECT
    The spread region is filled by repeating the alternating reflection of the gradient that is inside the gradient region.

  • XPS_SPREAD_METHOD_REPEAT
    The spread region is filled by repeating the gradient that is inside the gradient region, in the same orientation and direction.

Remarks

The following illustration shows the effect of the spread methods on gradients that are drawn by using the IXpsOMLinearGradientBrush and IXpsOMRadialGradientBrush interfaces. The gradient region of an IXpsOMLinearGradientBrush interface is defined by calling the SetStartPoint and SetEndPoint methods; the gradient region of an IXpsOMRadialGradientBrush interface is defined by calling the SetCenter, SetGradientOrigin, and SetRadiiSizes methods. The gradient region is the area inside the dashed lines, and the spread area is the area outside of the gradient region.

An illustration that shows examples of the spread method

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

See also

XML Paper Specification