Intermec Trakker T2090, User Manual

Page: 72 / 246

im_draw_underline
4-12
im_draw_underline
Purpose This function draws an underline on the screen between two points.
Syntax
#include "imt209x.h"
void im_draw_underline
(IM_USHORT
start_row,
IM_USHORT start_column,
IM_USHORT
end_row,
IM_USHORT end_column,
IM_USHORT
underline);
IN Parameters
start_row Specifies the number of the row where the underline starts.
start_column Specifies the number of the column where the underline starts.
end_row Specifies the number of the row where the underline ends.
end_column Specifies the number of the column one position after the column
where the underline ends.
underline Choose one of these constants:
IM_SET_UNDERLINE to draw the underline.
IM_CLEAR_UNDERLINE to erase the underline.
OUT Parameters
None.
Return Value None.
Notes The end_column parameter specifies one column beyond the underline to make
it easy for you to use im_get_cursor_xy to determine the values for start_row,
start_column, end_row, and end_column. Follow these steps:
1. Use im_get_cursor_xy to determine the cursor position, passing start_row
and start_column variables.
2. Display the text.
3. Use im_get_cursor_xy again to determine the cursor position (which is one
position beyond the end of the text displayed), passing end_row and
end_column variables.
4. Use im_draw underline to draw an underline under the text, passing
start_row, start_column , end_row, and end_column variables.
When you underline text, you should display the text first and then draw the
underline with this function.
If you use a function like im_puts, which lets you specify the underline
attribute for the text being put, you do not have to use im_draw_underline.