PathGradientBrush 函数
Windows GDI+ 公开一个由大约 600 个函数组成的平面 API，这些函数在 Gdiplus.dll 中实现并在 Gdiplusflat.h 中声明。 GDI+ 平面 API 中的函数由大约 40 个 C++ 类的集合包装。 建议不要直接调用平面 API 中的函数。 每当调用 GDI+ 时，都应该通过调用 C++ 包装器提供的方法和函数来执行此操作。 Microsoft 产品支持服务不会为直接调用平面 API 的代码提供支持。 有关使用这些包装器方法的详细信息，请参阅 GDI+ 平面 API。
以下平面 API 函数由 PathGradientBrush C++ 类包装。
PathGradientBrush 函数和相应的包装器方法
| 平面函数 | 包装器方法 | 备注 |
|---|---|---|
| GpStatus WINGDIPAPI GdipCreatePathGradient (GDIPCONST GpPointF* points、INT count、GpWrapMode wrapMode、GpPathGradient **polyGradient) |
PathGradientBrush：:P athGradientBrush ( IN const PointF* points，IN INT count，IN WrapMode wrapMode = WrapModeClamp) |
基于点数组创建 PathGradientBrush 对象。 初始化路径渐变画笔的环绕模式。 |
| GpStatus WINGDIPAPI GdipCreatePathGradientI (GDIPCONST GpPoint* points， INT count， GpWrapMode wrapMode， GpPathGradient **polyGradient) |
PathGradientBrush：:P athGradientBrush ( IN const Point* points， IN INT count， IN WrapMode wrapMode = WrapModeClamp) |
基于点数组创建 PathGradientBrush 对象。 初始化路径渐变画笔的环绕模式。 |
| GpStatus WINGDIPAPI GdipCreatePathGradientFromPath (GDIPCONST GpPath* path， GpPathGradient **polyGradient) |
PathGradientBrush：:P athGradientBrush ( IN const GraphicsPath* 路径) |
基于 GraphicsPath 对象创建 PathGradientBrush 对象。 |
| GpStatus WINGDIPAPI GdipGetPathGradientCenterColor ( GpPathGradient *brush， ARGB* 颜色) |
Status PathGradientBrush：：GetCenterColor (OUT Color* color) const |
获取此路径渐变画笔的中心点的颜色。 |
| GpStatus WINGDIPAPI GdipSetPathGradientCenterColor ( GpPathGradient *brush，ARGB 颜色) |
Status PathGradientBrush：：SetCenterColor (IN const Color& color) |
设置此路径渐变画笔的中心颜色。 中心颜色是画笔中心点处显示的颜色。 |
| GpStatus WINGDIPAPI GdipGetPathGradientSurroundColorsWithCount ( GpPathGradient *brush， ARGB* color， INT* count) |
Status PathGradientBrush：：GetSurroundColors (OUT Color* colors， IN OUT INT* count) const |
获取当前为此路径渐变画笔指定的环绕颜色。 |
| GpStatus WINGDIPAPI GdipSetPathGradientSurroundColorsWithCount ( GpPathGradient *brush， GDIPCONST ARGB* color， INT* count) |
Status PathGradientBrush：：SetSurroundColors (IN const Color* colors， IN OUT INT* count) |
设置此路径渐变画笔的周围颜色。 环绕颜色是为画笔边界路径上的离散点指定的颜色。 |
| GpStatus WINGDIPAPI GdipGetPathGradientPath (GpPathGradient *brush，GpPath *path) |
Status PathGradientBrush：：GetGraphicsPath (OUT GraphicsPath* path) const |
未在 GDI+ 版本 1.0 中实现。 |
| GpStatus WINGDIPAPI GdipSetPathGradientPath (GpPathGradient *brush， GDIPCONST GpPath *path) |
Status PathGradientBrush：：SetGraphicsPath (IN const GraphicsPath* path) |
未在 GDI+ 版本 1.0 中实现。 |
| GpStatus WINGDIPAPI GdipGetPathGradientCenterPoint ( GpPathGradient *brush， GpPointF* points) |
Status PathGradientBrush：：GetCenterPoint (OUT PointF* point) const |
获取此路径渐变画笔的中心点。 |
| GpStatus WINGDIPAPI GdipGetPathGradientCenterPointI ( GpPathGradient *brush， GpPoint* points) |
Status PathGradientBrush：：GetCenterPoint (OUT Point* point) const |
获取此路径渐变画笔的中心点。 |
| GpStatus WINGDIPAPI GdipSetPathGradientCenterPoint ( GpPathGradient *brush， GDIPCONST GpPointF* points) |
Status PathGradientBrush：：SetCenterPoint (IN const PointF& point) |
设置此路径渐变画笔的中心点。 默认情况下，中心点位于画笔边界路径的质心处，但你可以将中心点设置为路径内部或外部的任何位置。 |
| GpStatus WINGDIPAPI GdipSetPathGradientCenterPointI ( GpPathGradient *brush， GDIPCONST GpPoint* points) |
Status PathGradientBrush：：SetCenterPoint (IN const Point&) |
设置此路径渐变画笔的中心点。 默认情况下，中心点位于画笔边界路径的质心处，但你可以将中心点设置为路径内部或外部的任何位置。 |
| GpStatus WINGDIPAPI GdipGetPathGradientRect (GpPathGradient *brush， GpRectF *rect) |
Status PathGradientBrush：：GetRectangle (OUT RectF* rect) const |
获取包含此路径渐变画笔的边界路径的最小矩形。 |
| GpStatus WINGDIPAPI GdipGetPathGradientRectI (GpPathGradient *brush，GpRect *rect) |
Status PathGradientBrush：：GetRectangle (OUT Rect* rect) const |
获取包含此路径渐变画笔的边界路径的最小矩形。 |
| GpStatus WINGDIPAPI GdipGetPathGradientPointCount (GpPathGradient *brush， INT* count) |
INT PathGradientBrush：：GetPointCount () const |
获取定义此画笔边界路径的点数组中的点数。 |
| GpStatus WINGDIPAPI GdipGetPathGradientSurroundColorCount (GpPathGradient *brush， INT* count) |
INT PathGradientBrush：：GetSurroundColorCount () const |
获取已为此路径渐变画笔的边界路径指定的颜色数。 |
| GpStatus WINGDIPAPI GdipSetPathGradientGammaCorrection (GpPathGradient *brush， BOOL useGammaCorrection) |
Status PathGradientBrush：：SetGammaCorrection (IN BOOL useGammaCorrection) |
指定是否为此路径渐变画笔启用伽玛校正。 |
| GpStatus WINGDIPAPI GdipGetPathGradientGammaCorrection (GpPathGradient *brush， BOOL *useGammaCorrection) |
BOOL PathGradientBrush：：GetGammaCorrection () const |
确定是否为此路径渐变画笔启用伽玛校正。 |
| GpStatus WINGDIPAPI GdipGetPathGradientBlendCount (GpPathGradient *brush， INT *count) |
INT PathGradientBrush：：GetBlendCount () const |
获取当前为此路径渐变画笔设置的混合因子数。 |
| GpStatus WINGDIPAPI GdipGetPathGradientBlend (GpPathGradient *brush， REAL *blend， REAL *positions， INT count) |
PathGradientBrush：：GetBlend (OUT REAL* blendFactors， OUT REAL* blendPositions， INT count) const |
获取当前为此路径渐变画笔设置的混合因子和相应的混合位置。 |
| GpStatus WINGDIPAPI GdipSetPathGradientBlend (GpPathGradient *brush，GDIPCONST REAL *blend，GDIPCONST REAL *positions，INT count) |
Status PathGradientBrush：：SetBlend (IN const REAL* blendFactors， IN const REAL* blendPositions， IN IN INT count) |
设置此路径渐变画笔的混合因子和混合位置。 |
| GpStatus WINGDIPAPI GdipGetPathGradientPresetBlendCount (GpPathGradient *brush， INT *count) |
INT PathGradientBrush：：GetInterpolationColorCount () const |
获取当前为此路径渐变画笔指定的预设颜色数。 |
| GpStatus WINGDIPAPI GdipGetPathGradientPresetBlend (GpPathGradient *brush， ARGB *blend， REAL* positions， INT count) |
Status PathGradientBrush：：GetInterpolationColors (OUT Color* presetColors， OUT REAL* blendPositions， IN INT count) const |
获取当前为此路径渐变画笔指定的预设颜色和混合位置。 |
| GpStatus WINGDIPAPI GdipSetPathGradientPresetBlend (GpPathGradient *brush， GDIPCONST ARGB *blend， GDIPCONST REAL* positions， INT count) |
Status PathGradientBrush：：SetInterpolationColors (IN const Color* presetColors， IN const REAL* blendPositions， IN IN INT count) |
设置此路径渐变画笔的预设颜色和混合位置。 |
| GpStatus WINGDIPAPI GdipSetPathGradientSigmaBlend (GpPathGradient *brush， REAL focus， REAL scale) |
Status PathGradientBrush：：SetBlendBellShape (IN REAL focus， IN REAL scale = 1.0) |
设置此路径渐变画笔的混合形状。 |
| GpStatus WINGDIPAPI GdipSetPathGradientLinearBlend (GpPathGradient *brush， REAL focus， REAL scale) |
Status PathGradientBrush：：SetBlendTriangularShape ( IN REAL focus， IN REAL scale = 1.0 ) |
设置此路径渐变画笔的混合形状。 |
| GpStatus WINGDIPAPI GdipGetPathGradientWrapMode (GpPathGradient *brush，GpWrapMode *wrapmode) |
WrapMode PathGradientBrush：：GetWrapMode () const |
获取当前为此路径渐变画笔设置的环绕模式。 |
| GpStatus WINGDIPAPI GdipSetPathGradientWrapMode (GpPathGradient *brush，GpWrapMode wrapmode) |
Status PathGradientBrush：：SetWrapMode (IN WrapMode wrapMode) |
设置此路径渐变画笔的环绕模式。 |
| GpStatus WINGDIPAPI GdipGetPathGradientTransform (GpPathGradient *brush， GpMatrix *matrix) |
Status PathGradientBrush：：GetTransform (OUT Matrix *matrix) const |
获取此路径渐变画笔的转换矩阵。 |
| GpStatus WINGDIPAPI GdipSetPathGradientTransform (GpPathGradient *brush， GpMatrix *matrix) |
Status PathGradientBrush：：SetTransform (IN const Matrix* matrix) |
设置此路径渐变画笔的转换矩阵。 |
| GpStatus WINGDIPAPI GdipResetPathGradientTransform (GpPathGradient* 画笔) |
Status PathGradientBrush：：ResetTransform () |
将此路径渐变画笔的转换矩阵重置为标识矩阵。 这意味着不会发生任何转换。 |
| GpStatus WINGDIPAPI GdipMultiplyPathGradientTransform (GpPathGradient* brush， GDIPCONST GpMatrix *matrix， GpMatrixOrder order) |
Status PathGradientBrush：：MultiplyTransform (IN const Matrix* matrix， IN MatrixOrder order = MatrixOrderPrepend) |
汇报画笔的变换矩阵以及自身和另一个矩阵的乘积。 |
| GpStatus WINGDIPAPI GdipTranslatePathGradientTransform (GpPathGradient* brush， REAL dx， REAL dy， GpMatrixOrder order) |
Status PathGradientBrush：：TranslateTransform (IN REAL dx， IN REAL dy， IN MatrixOrder 顺序 = MatrixOrderPrepend) |
汇报此画笔的当前转换矩阵及其本身的乘积和转换矩阵。 |
| GpStatus WINGDIPAPI GdipScalePathGradientTransform (GpPathGradient* brush， REAL sx， REAL sy， GpMatrixOrder order) |
Status PathGradientBrush：：ScaleTransform (IN REAL sx，IN REAL sy，IN MatrixOrder 顺序 = MatrixOrderPrepend) |
汇报此画笔的当前转换矩阵以及其自身的乘积和缩放矩阵。 |
| GpStatus WINGDIPAPI GdipRotatePathGradientTransform (GpPathGradient* brush， REAL angle， GpMatrixOrder order) |
Status PathGradientBrush：：RotateTransform (IN REAL angle， IN MatrixOrder 顺序 = MatrixOrderPrepend) |
汇报此画笔的当前转换矩阵及其本身的乘积和旋转矩阵。 |
| GpStatus WINGDIPAPI GdipGetPathGradientFocusScales (GpPathGradient *brush， REAL* xScale， REAL* yScale) |
状态 PathGradientBrush：：GetFocusScales (OUT REAL* xScale， OUT REAL* yScale) const |
获取此路径渐变画笔的焦点比例。 |
| GpStatus WINGDIPAPI GdipSetPathGradientFocusScales (GpPathGradient *brush， REAL xScale， REAL yScale) |
Status PathGradientBrush：：SetFocusScales (IN REAL xScale，IN REAL yScale) |
设置此路径渐变画笔的焦点比例 |
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈