DisplayPCXFile
int DisplayPCXFile (char filename[], int top, int left);
Purpose
![]() |
Note This function has been superseded by DisplayImageFile. Repeated use of DisplayPCXFile clutters the panel with redundant controls and causes other unpredictable behavior. |
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: .tif, .pcx, .bmp, .dib, .rle, .ico, .jpg, .png, .wmf, and .emf.
(Linux) This function supports the following image types: .pcx, .jpg, and .xwd.
Parameters
Input | ||
Name | Type | Description |
filename | char [] | 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. |
top | int | 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. |
left | int | 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 | int | The picture ID you can use to specify this control in subsequent function calls. Negative values indicate that an error occurred. |
Additional Information
Library: User Interface Library
Include file: userint.h
LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later