Funções LinearGradientBrush
O Windows GDI+ expõe uma API simples que consiste em cerca de 600 funções, que são implementadas em Gdiplus.dll e declaradas em Gdiplusflat.h. As funções na API plana GDI+ são encapsuladas por uma coleção de cerca de 40 classes C++. É recomendável que você não chame diretamente as funções na API simples. Sempre que você fizer chamadas para GDI+, deverá fazer isso chamando os métodos e as funções fornecidos pelos wrappers C++. Os Serviços de Suporte a Produtos da Microsoft não fornecerão suporte para o código que chama a API simples diretamente. Para obter mais informações sobre como usar esses métodos wrapper, consulte API Simples GDI+.
As funções de API simples a seguir são encapsuladas pela classe LinearGradientBrush C++.
Funções LinearGradientBrush e métodos wrapper correspondentes
| Função simples | Método Wrapper | Comentários |
|---|---|---|
| GpStatus WINGDIPAPI GdipCreateLineBrush(GDIPCONST GpPointF* point1, GDIPCONST GpPointF* point2, ARGB color1, ARGB color2, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const PointF& point1, IN const PointF& point2, IN const Color color1& , IN const Color color2& ) | Cria um objeto LinearGradientBrush de um conjunto de pontos de limite e cores de limite. LinearGradientBrush(IN const PointF& point1, IN const PointF& point2, IN const Color color1& , IN const Color& color2) O parâmetro wrapMode na função plana é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipCreateLineBrushI(GDIPCONST GpPoint* point1, GDIPCONST GpPoint* point2, ARGB color1, ARGB color2, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const Point point1& , IN const Point& point2, IN const Color color1& , IN const Color color2& ) | Cria um objeto LinearGradientBrush de um conjunto de pontos de limite e cores de limite. O parâmetro wrapMode na função simples é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipCreateLineBrushFromRect(GDIPCONST GpRectF* rect, ARGB color1, ARGB color2, LinearGradientMode mode, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const RectF& rect, IN const Color color1& , IN const Color& color2, IN LinearGradientMode mode) |
Cria um objeto LinearGradientBrush com base em um retângulo e modo de direção. O parâmetro wrapMode na função simples é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipCreateLineBrushFromRectI(GDIPCONST GpRect* rect, ARGB color1, ARGB color2, LinearGradientMode mode, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const Rect& rect, IN const Color color1& , IN const Color color2& , IN LinearGradientMode mode) |
Cria um objeto LinearGradientBrush com base em um retângulo e modo de direção. O parâmetro wrapMode na função simples é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipCreateLineBrushFromRectWithAngle(GDIPCONST GpRectF* rect, ARGB color1, ARGB color2, REAL angle, BOOL isAngleScalable, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const RectF& rect, IN const Color color1& , IN const Color& color2, IN REAL angle, IN BOOL isAngleScalable = FALSE) |
Cria um objeto LinearGradientBrush de um retângulo e ângulo de direção. O parâmetro wrapMode na função simples é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipCreateLineBrushFromRectWithAngleI(GDIPCONST GpRect* rect, ARGB color1, ARGB color2, REAL angle, BOOL isAngleScalable, GpWrapMode wrapMode, GpLineGradient **lineGradient) |
LinearGradientBrush::LinearGradientBrush(IN const Rect& rect, IN const Color color1& , IN const Color color2& , IN REAL angle, IN BOOL isAngleScalable = FALSE) |
Cria um objeto LinearGradientBrush de um retângulo e ângulo de direção. O parâmetro wrapMode na função simples é um membro da enumeração WrapMode que especifica como as áreas preenchidas com o pincel são lado a lado. |
| GpStatus WINGDIPAPI GdipSetLineColors(GpLineGradient *brush, ARGB color1, ARGB color2) |
Status LinearGradientBrush::SetLinearColors(IN const Color color1& , IN const Color color2& ) |
Define a cor inicial e a cor final desse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipGetLineColors(GpLineGradient *brush, ARGB* colors) |
Status LinearGradientBrush::GetLinearColors(OUT Color* colors) const |
Obtém a cor inicial e a cor final desse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipGetLineRect(GpLineGradient *brush, GpRectF *rect) |
Status LinearGradientBrush::GetRectangle(OUT RectF* rect) const |
Obtém o retângulo que define os limites do gradiente. |
| GpStatus WINGDIPAPI GdipGetLineRectI(GpLineGradient *brush, GpRect *rect) |
Status LinearGradientBrush::GetRectangle(OUT Rect* rect* rect) const |
Obtém o retângulo que define os limites do gradiente. |
| GpStatus WINGDIPAPI GdipSetLineGammaCorrection(GpLineGradient *brush, BOOL useGammaCorrection) |
Status LinearGradientBrush::SetGammaCorrection(IN BOOL useGammaCorrection) |
Especifica se a correção gama está habilitada para esse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipGetLineGammaCorrection(GpLineGradient *brush, BOOL *useGammaCorrection) |
BOOL LinearGradientBrush::GetGammaCorrection() const |
Determina se a correção gama está habilitada. |
| GpStatus WINGDIPAPI GdipGetLineBlendCount(GpLineGradient *brush, INT *count) |
INT LinearGradientBrush::GetBlendCount() const |
Obtém o número de fatores de mesclagem definidos no momento. |
| GpStatus WINGDIPAPI GdipGetLineBlend(GpLineGradient *brush, REAL *blend, REAL* positions, INT count) |
Status LinearGradientBrush::GetBlend(OUT REAL* blendFactors, OUT REAL* blendPositions, IN INT count) const |
Obtém os fatores de mesclagem e suas posições de combinação correspondentes de um objeto LinearGradientBrush . |
| GpStatus WINGDIPAPI GdipSetLineBlend(GpLineGradient *brush, GDIPCONST REAL *blend, GDIPCONST REAL* positions, INT count) |
Status LinearGradientBrush::SetBlend(IN const REAL* blendFactors, IN const REAL* blendPositions, IN INT count) |
Define os fatores de mesclagem e as posições de mesclagem desse pincel de gradiente linear para criar uma mistura personalizada. |
| GpStatus WINGDIPAPI GdipGetLinePresetBlendCount(GpLineGradient *brush, INT *count) |
INT LinearGradientBrush::GetInterpolationColorCount() const |
Obtém o número de cores atualmente definidas para serem interpoladas para esse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipGetLinePresetBlend(GpLineGradient *brush, ARGB *blend, REAL* positions, INT count) |
Status LinearGradientBrush::GetInterpolationColors(OUT Color* presetColors, OUT REAL* blendPositions, IN INT count) const |
Obtém as cores definidas atualmente para serem interpoladas para esse pincel de gradiente linear e suas posições de combinação correspondentes. |
| GpStatus WINGDIPAPI GdipSetLinePresetBlend(GpLineGradient *brush, GDIPCONST ARGB *blend, GDIPCONST REAL* positions, INT count) |
Status LinearGradientBrush::SetInterpolationColors(IN const Color* presetColors, IN const REAL* blendPositions, IN INT count) |
Define as cores a serem interpoladas para esse pincel de gradiente linear e suas posições de combinação correspondentes. |
| GpStatus WINGDIPAPI GdipSetLineSigmaBlend(GpLineGradient *brush, REAL focus, REAL scale) |
Status LinearGradientBrush::SetBlendBellShape(IN REAL focus, IN REAL scale = 1.0f) |
Define a forma de mesclagem desse pincel de gradiente linear para criar uma mistura personalizada com base em uma curva em forma de sino. |
| GpStatus WINGDIPAPI GdipSetLineLinearBlend(GpLineGradient *brush, REAL focus, REAL scale) |
Status LinearGradientBrush::SetBlendTriangularShape( IN REAL focus, IN REAL scale = 1.0f ) |
Define a forma de mesclagem deste pincel de gradiente linear para criar uma mistura personalizada com base em uma forma triangular. |
| GpStatus WINGDIPAPI GdipSetLineWrapMode(GpLineGradient *brush, GpWrapMode wrapmode) |
Status LinearGradientBrush::SetWrapMode(IN WrapMode wrapMode) |
Define o modo de encapsulamento desse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipGetLineWrapMode(GpLineGradient *brush, GpWrapMode *wrapmode) |
WrapMode LinearGradientBrush::GetWrapMode() const |
Obtém o modo de encapsulamento para este pincel. O modo de encapsulamento determina como uma área é lado a lado quando é pintada com um pincel. |
| GpStatus WINGDIPAPI GdipGetLineTransform(GpLineGradient *brush, GpMatrix *matrix) |
Status LinearGradientBrush::GetTransform(OUT Matrix *matrix) const |
Obtém a matriz de transformação desse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipSetLineTransform(GpLineGradient *brush, GDIPCONST GpMatrix *matrix) |
Status LinearGradientBrush::SetTransform(IN const Matrix* matrix* matrix) |
Define a matriz de transformação desse pincel de gradiente linear. |
| GpStatus WINGDIPAPI GdipResetLineTransform(GpLineGradient* brush) |
Status LinearGradientBrush::ResetTransform() |
Redefine a matriz de transformação desse pincel de gradiente linear para a matriz de identidade. Isso significa que nenhuma transformação ocorre. |
| GpStatus WINGDIPAPI GdipMultiplyLineTransform(GpLineGradient* brush, GDIPCONST GpMatrix *matrix, GpMatrixOrder order) |
Status LinearGradientBrush::MultiplyTransform(IN const Matrix* matrix, IN MatrixOrder order = MatrixOrderPrepend) |
Atualizações a matriz de transformação desse pincel com o produto de si mesmo e outra matriz. |
| GpStatus WINGDIPAPI GdipTranslateLineTransform(GpLineGradient* brush, REAL dx, REAL dy, gpMatrixOrder order) |
Status LinearGradientBrush::TranslateTransform(IN REAL dx, IN REAL dy, IN MatrixOrder order = MatrixOrderPrepend) |
Atualizações a matriz de transformação atual desse pincel com o produto de si mesmo e uma matriz de tradução. |
| GpStatus WINGDIPAPI GdipScaleLineTransform(GpLineGradient* brush, REAL sx, REAL sy, gpMatrixOrder order) |
Status LinearGradientBrush::ScaleTransform(IN REAL sx, IN REAL sy, IN MatrixOrder order = MatrixOrderPrepend) |
Atualizações a matriz de transformação atual desse pincel com o produto de si mesmo e uma matriz de dimensionamento. |
| GpStatus WINGDIPAPI GdipRotateLineTransform(GpLineGradient* brush, REAL angle, GpMatrixOrder order) |
Status LinearGradientBrush::RotateTransform(IN REAL angle, IN MatrixOrder order = MatrixOrderPrepend) |
Atualizações a matriz de transformação atual desse pincel com o produto de si mesmo e uma matriz de rotação. |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de