ImagePalette Property

Returns or sets the palette to use when displaying an image.

Available With

Ö Imaging for Windows Professional Edition V1.0, V1.1, and V2.0
Ö Imaging for Windows 95 and 98
Ö Imaging for Windows NT 4.0

Applies To

Image Edit control

Syntax

object.ImagePalette[=value]

Data Type

Integer (enumerated)

Property settings are expressed using the following values:

Constant Setting Description Notes

wiPaletteCustom 0

(default)

Custom Selects a custom palette
wiPaletteCommon 1 Common Selects the common palette
wiPaletteGray8 2 Gray8 Selects the 8-bit gray-scale, 256 shades-of-gray palette
wiPaletteRGB24 3 RGB24 Selects the 24-bit, millions-of-colors palette
wiPaletteBlackWhite 4 Black-and-white Selects the black-and-white palette

Remarks

The ImagePalette value can be specified before or after an image is displayed.  If the value is specified after an image is displayed, the displayed image may change visually.

When the AutoRefresh property is set to True, changing the ImagePalette property causes the displayed image to be refreshed automatically.

When the Image Edit and Image Thumbnail controls are used together, the ImagePalette property must be set to the Common palette (wiPaletteCommon) when the PageType of the image being displayed in the Image Edit control is not RGB.

When the PageType of the image being displayed in the Image Edit control is RGB, the ImagePalette property must be set to the RGB24 palette (wiPaletteRGB24).