Admin Production ni-theme
Current Publication

ConfigurePrinter

LabWindows/CVI

ConfigurePrinter

int ConfigurePrinter (char printFile[], int orientation, int imageWidth, int imageHeight, int ejectAfter);

Purpose

Note   This function has been superseded by SetPrintAttribute.

Sets the orientation, height, width, and eject after print attributes.

Parameters

Input
Name Type Description
printFile char [] LabWindows/CVI ignores printFile because you specify the print file at the system level.
orientation int Orientation of the image on the page.

Valid Values
1 = VAL_PORTRAIT (Default)
2 = VAL_LANDSCAPE
imageWidth int Width of the image in millimeter/10 or VAL_USE_PRINTER_DEFAULT or VAL_INTEGRAL_SCALE.

Depending on the resolution of the display adapter and the printer, specifying an absolute width can produce aliasing in the output.

Aliasing occurs when lines on the screen are either lost or duplicated in a uneven manner on the printer.

You can prevent aliasing by specifying a width of VAL_INTEGRAL_SCALE. This action causes the image width to be based on the image length. In this case, the image is scaled using an integral ratio (1:1, 1:2, 1:3, and so on) that produces an image on the printer less than or equal to the specified length. If the length is also VAL_INTEGRAL_SCALE, a scaling ratio of 1:1 is used.
imageHeight int Height of the image in millimeter/10 or VAL_USE_PRINTER_DEFAULT or VAL_INTEGRAL_SCALE.

Depending on the resolution of the display adapter and the printer, specifying an absolute height can produce aliasing in the output.

Aliasing occurs when lines on the screen are either lost or duplicated in a uneven manner on the printer.

You can prevent aliasing by specifying a height of VAL_INTEGRAL_SCALE. This action causes the image height to be based on the image width. In this case, the image is scaled using an integral ratio (1:1, 1:2, 1:3, and so on) that produces a image on the printer less than or equal to the specified length. If the length is also VAL_INTEGRAL_SCALE, a scaling ratio of 1:1 is used.
ejectAfter int Specifies whether to eject the paper from the printer after the next call to a printing function.

Specify a nonzero value or select yes in the function panel to print output on a separate page.

Specify 0 or select no in the function panel to print output on the same page.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later