SetRgnColor method (Main Control)
Builder Syntax |
int SetRgnColor (int crColor, Cardinal uCombineMode); |
Delphi Syntax |
SetRgnColor (crColor:TColorRef; uCombineMode:Cardinal): Integer; |
Overview |
Refer to Creating and Using a Bitmap Region. |
Remarks
Adds a region that consists of all pixels of a specified color.
You specify the color using a COLORREF value, which is a Windows-defined data type. You can also specify a palette index as explained in Using Palette Indexes As Color Values.
With this method, you can either replace the current region or create a complex region by setting a Boolean flag that determines how the added region interacts with the existing region. For possible values, specified in the uCombineMode parameter, refer to Flags for Setting a Region.
You can use this method to simulate the use of a transparent color as follows:
Call this method, with the transparent color
in the crColor parameter and
L_RGN_SETNOT in the uCombineMode
parameter.
Use the EnableFloater
property to display and manipulate the region, which consists of every
part of the bitmap, except the area with the specified color.
This method does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this method.
See Also
Elements: |
SetRgnEllipse method, SetRgnRect method, SetRgnRoundRect method, PolygonSize property, OffsetRgn method |
Topics: |
|
|