DisplayPCXFile

int DisplayPCXFile (char filename[], int controlTop, int controlLeft);

Purpose

Displays the contents of an image file in a new picture control on the DOS Compatibility window at the given x- and y-coordinates. Use DisplayPCXFile to create the DOS Compatibility window if it has not yet been created.

This function supports the following image types: .pcx, .bmp, .dib, .rle, .ico, .jpg, .png, .wmf, and .emf.

Linux This function supports the following image types: .pcx, .jpg, and .xwd.

Note   DisplayPCXFile has been superseded by DisplayImageFile. Repeated use of DisplayPCXFile clutters the panel with redundant controls and causes other unpredictable behavior.

Parameters

Input
Name Type Description
filename string Name of the image file that contains the image.

If the name is a simple filename with no directory path, the file is loaded from the directory that contains the executable.
controlTop integer Coordinate of the top edge of the image.

The coordinates can be any value between 0 and 32,767. The origin is in the upper-left corner directly beneath the title bar before the panel is scrolled.
controlLeft integer Coordinate of the left edge of the image.

The coordinates can be any value between 0 and 32,767. The origin is in the upper-left corner directly beneath the title bar before the panel is scrolled.

Return Value

Name Type Description
pictureID integer The picture ID you can use to specify this control in subsequent function calls.

Negative values indicate that an error occurred.

Code Error Message String
xx Success