Returns or sets the palette to use when displaying an image.
Ö | Imaging for Windows Professional Edition V1.0, V1.1, and V2.0 |
Ö | Imaging for Windows 95 and 98 |
Ö | Imaging for Windows NT 4.0 |
Image Edit control
object.ImagePalette[=value]
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 |
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).