JYACC FORMAKER C Programmer's Guide Contents 1 ... - Prolifics

NAMESYNOPSISsm_d_msg_line - display a message on the status line#include "smdefs.h"void sm_d_msg_line (message, attrib)char *message;int attrib;DESCRIPTIONThe message in message is displayed on the status line, with an initial displayattribute of attrib. This message overrides background status text and fieldstatus text; it will itself be overwritten by sm_err_reset and relatedfunctions, or by the ready/wait message enabled by sm_setstatus.Several percent escapes provide control over the content and presentation ofstatus messages. They are interpreted by sm_d_msg_line, which is eventuallycalled by everything that puts text on the status line (including field statustext). The character following the percent sign must be in upper-case; this isto avoid conflict with the percent escapes used by printf and its variants.Certain percent escapes (%W, for instance; see below) must appear at thebeginning of the message, i.e. before anything except perhaps another percentescape......If a string of the form %Annnn appears anywhere in the message, thehexadecimal number nnnn is interpreted as a display attribute to beapplied to the remainder of the message. The table below gives thenumeric values of the logical display attributes you will need toconstruct embedded attributes. If you want a digit to appearimmediately after the attribute change, pad the attribute to 4 digitswith leading zeroes; if the following character is not a legal hexdigit, leading zeroes are unnecessary.If a string of the form %KKEYNAME appears anywhere in the message,KEYNAME is interpreted as a logical key mnemonic, and the wholeexpression is replaced with the key label string defined for that keyin the key translation file. If there is no label, the %K is strippedout and the mnemonic remains. Key mnemonics are defined in smkeys.h ;it is of course the name, not the number, that you want here. Themnemonic must be in upper-case.If %N appears anywhere in the message, the latter will be presented ina pop-up window rather than on the status line, and all occurrences of%N will be replaced by newlines.If the message begins with a %B, JYACC FORMAKER will beep the terminal(using sm_bel) before issuing the message.If the message begins with %W, it will be presented in a pop-up windowinstead of on the status line. The window will appear near the bottomcenter of the screen, unless it would obscure the current field by sodoing; in that case, it will appear near the top. If the messagebegins with %MU or %MD, and is passed to one of the error messagedisplay functions, JYACC FORMAKER will ignore the default error messageacknowledgement flag and process (for %MU) or discard (for %MD) thenext character typed.