Dynapro Technologies Dynapro ET TCS, Руководство разработчика приложений

Страница: 138 / 337

5-51
'UDZ%DUIRU%DU&KDUW&RPPDQG^)'%%`5HPRWH
The Draw Bar for Bar Chart command provides a convenient way to display and update a bar
chart. The command supports both horizontal or vertical bar charts. To use the command, the
host specifies:
•
The maximum length or height of the bar
•
The amount of the bar to be filled in one-tenth of one percent precision (.0% through
100.0%)
The bar is drawn using block characters. If necessary, the TCS uses partial characters at the edge
of the bar to represent the proper fill percentage. The part of the bar beyond the portion filled
with block characters is automatically erased.
The bar starts at the current cursor position and extends upward for a vertical bar, or to the right
for a horizontal bar. The host can also specify how thick the bar is to be drawn. If a bar is being
drawn and a thickness greater than 1 is specified, the thickness extends to the right of the cursor
for a vertical bar or below the cursor for a horizontal bar.
Figure 5-9, which represents bars that are two characters in thickness, shows how a bar is drawn
relative to the cursor position.
The bar chart command automatically takes into account the line type of the area in which the
bar is drawn, as long as the line types in the area are not mixed (all normal, all double-wide, or
all alternating double-size). Note that the resolution of partial characters placed on a double-size
line is reduced when a vertical bar is drawn. In this situation, the resolution of the partial fill
character is reduced from 1/10th of a line to 1/5th of a line. Unless double-size lines are required
for text that shares the same lines as the vertical bar (such as labels), it is recommended that
double-wide lines be used instead. This provides a vertical bar of the same physical size, but with
partial characters of twice the resolution.
)LJXUH9HUWRUL]RQWDO%DUV
The Draw Bar for Bar Chart command does not change the cursor position.