PFileName Property

Description

Gets and sets the filename that contains the palette for the control.

Property Type

Read-write property

Syntax

Visual Basic
Public Property PFileName As String

Return Type

The filename of the palette for the control.

Remarks

Palette files can be DIB, BMP, or PAL files.

When the Palette property is 3 PaletteFile, images loaded using the FileName property, hDIB property, or LoadBlob method will be displayed using the palette of the image or palette file specified by the PFileName property.
When the ColorDepth method is invoked and the Palette parameter is set to 3 - Palette File, the palette in the file is used for color mapping.

Note: PAL is a Windows palette file conforming to the RIFF specification. You can use Microsoft BitEdit or PalEdit to create and save .PAL files. BitEdit and PalEdit Multimedia Data Tools ship with Microsoft Video for Windows.

The ImagError property is set if there is an error loading the palette file. If the palette file is invalid and a image is to be displayed or processed using the palette file, an optimized palette is generated and used.