Admin Production ni-theme
Current Publication

DisplayPCXFile

LabWindows/CVI

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