Partager via


IXRLinearGradientBrush::SetEndPoint (Windows Embedded CE 6.0)

1/6/2010

This method sets the two-dimensional coordinates of the ending point for this linear gradient.

Syntax

virtual HRESULT STDMETHODCALLTYPE SetEndPoint(
    XRPoint* pEndPoint
) = 0;

Parameters

  • pEndPoint
    [in] Pointer to an XRPoint structure that specifies the x-y coordinates of the gradient endpoint.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

An IXRLinearGradientBrush paints a gradient along a line. The line's starting points and endpoints are defined by IXRLinearGradientBrush::SetStartPoint and SetEndPoint in the IXRLinearGradientBrush class.

The default linear gradient is diagonal, and the default mode for the gradient coordinate system is XRBrushMappingMode_RelativeToBoundingBox. When the inherited method IXRGradientBrush::GetMappingMode returns the mapping mode XRBrushMappingMode_RelativeToBoundingBox, pEndPoint is a logical point, where values between 0 and 1 are mapped against the total size of the resulting bounding box. By default, the pEndPoint value of a linear gradient is an XRPoint value of (1,1), the lower-right corner of the area being painted. The colors in the resulting gradient are interpolated and applied along vectors that parallel this diagonal axis.

.NET Framework Equivalent

System.Windows.Media.LinearGradientBrush.EndPoint

Requirements

Header XamlRuntime.h
sysgen SYSGEN_XAML_RUNTIME
Windows Embedded CE Windows Embedded CE 6.0 R3

See Also

Reference

IXRLinearGradientBrush
IXRLinearGradientBrush::GetEndPoint