SetStdioWindowPosition

int SetStdioWindowPosition (int top, int left);

Purpose

Sets the current position, in pixels, of the client area of the Standard Input/Output Window relative to the upper left corner of the screen when you set the Standard I/O port to CVI_STDIO_WINDOW. The client area begins under the title bar and to the left of the frame.

Sets the position of the client area of the console window relative to the upper left corner of the screen when you set the Standard I/O port to HOST_SYSTEM_STDIO.

Parameters

Input
Name Type Description
top integer For CVI_STDIO_WINDOW, distance relative to the top of the screen, in pixels, of the top of client area of the Standard Input/Output window.

For HOST_SYSTEM_STDIO, distance relative to the top of the screen, in pixels, of the top of client area of the console window.

To vertically center the Standard Input/Output Window client area or the console window within the areas of the screen, pass VAL_AUTO_CENTER.

Valid Range: VAL_AUTO_CENTER
-16000 to +16000
left integer For CVI_STDIO_WINDOW, distance relative to the left edge of the screen, in pixels, of the left edge of client area of the Standard Input/Output window. The client area begins directly to the right of the frame.

For HOST_SYSTEM_STDIO, distance relative to the left edge of the screen, in pixels, of the left edge of client area of the console window.

To horizontally center the Standard Input/Output Window client area or console window within the areas of the screen, pass VAL_AUTO_CENTER.

Valid Range: VAL_AUTO_CENTER
-16000 to +16000

Return Value

Name Type Description
status integer Indicates whether the function succeeded.

Code Description
0 Success.
-1 top is not within the valid range.
-2 left is not within the valid range.
-3 This function can be called only from the main thread of your program.