Classes and Member Functions > LPaintEffect > LPaintEffect Member Functions > LPaintEffect::DrawGradient

LPaintEffect::DrawGradient

#include "ltwrappr.h"

virtual L_INT LPaintEffect::DrawGradient(pRect, uStyle)

LPRECT pRect;	the bounding rectangle
L_UINT uStyle;	the gradient style

Draws a rectangle into the target device context, and then fills the rectangle with a gradient.

Parameter	Description
pRect	The bounding rectangle.
uStyle	The gradient style. For possible values, refer to Effect Gradient Styles.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Use LPaintEffect::SetGradientParameters to control the properties of the gradient.

Required DLLs and Libraries

LTDIS
LTEFX

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

Example

L_INT LPaintEffect__DrawGradientExample(LBitmapBase& LeadBitmap,HDC hDC) 
{ 
   L_INT nRet; 
   LPaintEffect LeadPaintEffect ; 
   GRADIENTDLGPARAMS GradDlgParm; 
   RECT Rect ; 
   LeadPaintEffect.SetBitmap(&LeadBitmap) ; 
   LeadPaintEffect.SetDC(hDC) ; 
   LeadPaintEffect.GetGradientParameters(&GradDlgParm) ; 
   GradDlgParm.uSteps = 3 ; 
   nRet = LeadPaintEffect.SetGradientParameters(&GradDlgParm) ; 
   if(nRet != SUCCESS) 
      return nRet; 
   Rect.left = 0 ; 
   Rect.top = 0 ; 
   Rect.right = LeadBitmap.GetWidth() ; 
   Rect.bottom = LeadBitmap.GetHeight() ; 
   nRet = LeadPaintEffect.DrawGradient(&Rect,EFX_GRADIENT_CONE_FROM_RB) ; 
   if(nRet != SUCCESS) 
      return nRet; 
   LeadPaintEffect.SetDC(0); 
   return SUCCESS; 
}