Intermec 5055 Reference Guide
im_status_line
5-72
im_status_line
Purpose:
This function briefly displays an error message in the status line without wrapping or
scrolling the display. The status line is displayed until a key is pressed or a time out
occurs. The original contents of the line reappear after the message is erased.
scrolling the display. The status line is displayed until a key is pressed or a time out
occurs. The original contents of the line reappear after the message is erased.
Syntax:
#include "im5055.h"
int far im_status_line
(char far *
(char far *
msg
IM_BOOL
wait
IM_USHORT
row
);
IN Parameters:
msg Pointer to the error message string to display.
wait Specifies if the application should wait for a key to be pressed. Choose one of
these values:
these values:
0
Do not wait for a key.
non-zero Pause until any key is pressed or until a timeout occurs.
row Row number to display the message in. If this number is larger than the number
of visible rows, the last row is used. The first row is 0.
of visible rows, the last row is used. The first row is 0.
OUT Parameters:
None.
Return Value:
Returns 0 or the key pressed to terminate waiting.
Notes:
If the wait parameter is set, the message will be erased after 20 seconds or when a key is
pressed. Then, the screen is refreshed to look as it did before displaying the message.
pressed. Then, the screen is refreshed to look as it did before displaying the message.