LargePictureMaskColor

Applies to

ListView controls

Description

The mask color is the color in the picture that is transparent when the picture is displayed.

Select the color to mask newly added user-defined bitmaps. In scripts, you can change the mask color before adding each picture. Each image uses the mask color that was in effect when it was added.

Usage


In a painter

StepsTo specify a picture mask color:

  1. Select a color from the Picture Mask Color drop-down list on the Large Picture tab page of the control’s Properties view.

To add your own colors to the color drop-down list, select Design>Custom Colors before displaying the Properties view.


In scripts

The LargePictureMaskColor property takes a long (-2 to 16,777,215) that specifies the numerical value of the background color. This property is used when each bitmap is added and, therefore, can be changed between AddLargePicture calls.

The LargePictureMaskColor value is a combination of values for the red, green, and blue components of the color. If you do not know the long value for a particular color, choose Design>Custom Colors to determine the red, green, and blue values and then call the RGB function to specify the color in a script.

The following example sets yellow as the mask color for user-defined bitmaps in a ListView:

lv_1.LargePictureMaskColor = RGB(255, 255, 0)