Method function IGDIPlus.IGPImageAttributes.SetColorKey(TGPColor;TGPColor;TGPColorAdjustType) : TGPImageAttributes

From Mitov Wiki Doc
Jump to: navigation, search

This is a Beta Read Only version of this page. Please review and send recommendations to We will enable the editing as soon as we are happy with the overall Wiki site.

Class: IGPImageAttributes




function SetColorKey( colorLow : TGPColor, colorHigh : TGPColor, type_ : TGPColorAdjustType ) : TGPImageAttributes;

C++ Builder:

TGPImageAttributes __fastcall SetColorKey( TGPColor colorLow, TGPColor colorHigh, TGPColorAdjustType type_ );

Visual C++ (MFC):

SetColorKey(  colorLow,  colorHigh,  type_ );


Sets the color key (transparency range) for a specified category.


Call this method to set the color key (transparency range) for a specified category. Remarks This method sets the high and low color-key values so that arange of colors can be made transparent. Any color that has each of its three components (red, green, blue) between the corresponding components of the high and low color keys is made transparent.

An TGPImageAttributes object maintains color and grayscale settings for five adjustment categories: default, bitmap, brush, pen, and text. For example, you can specify a color key for the default category, a different color key for the bitmap category, and still a different color key for the pen category.

The default color- and grayscale-adjustment settings apply to all categories that don't have adjustment settings of their own. For example, if you never specify any adjustment settings for the pen category, then the default settings apply to the pen category.

As soon as you specify a color- or grayscale-adjustment setting for a certain category, the default adjustment settings no longer apply to that category. For example, suppose you specify a collection of adjustment settings for the default category. If you set the color key for the pen category by passing ColorAdjustTypePen to the SetColorKey method, then none of the default adjustment settings will apply to pens.

Personal tools