Mnemonics "I"

From CometWiki

---

Revision as of 00:29, 1 June 2009

Contents 1 (Ignore Windows) 2 (Init Input Data) 3 (Insert Off) 4 (Insert On)

(Ignore Windows)

 
Mnemonic:   (Ignore Windows)  
Discussion:  This mnemonic allows you to write anyplace on the screen disregarding the presence of windows.  

(Init Input Data)

 
Mnemonic:  (Init Input Data)  
Discussion:  The (Init Input Data) mnemonic is a one-time function that when issued prior to a new INPUT statement causes the screen field(s) to be initialized from the current variable(s) instead of from the existing screen data. 
Rules for using this mnemonic: 


The current variable(s) must be set prior to using (Init Input Data) 
(Init Input Data) must be issued prior to the INPUT statement to which it applies 
(Init Input Data) is a one-time function 
This mnemonic works with a single input value as well as multiple input values within a single INPUT statement. 

Note: This mnemonic applies to the new INPUT statement, not to the legacy INPUT statement. 
 
Example 1:  LENGTH 1 & LOCAL OPTION$
.
.
.
OPTION$ = "Y"
Print (Init Input Data)
Input @(10,10),OPTION$

 

In this example, OPTION$ is set to an initial value of "Y" and the (Init Input Data) mnemonic is issued before the INPUT statement. When the INPUT statement is executed, "Y" is displayed at column 10, row 10, and the cursor is positioned at that same location. 
 
Example 2:  LENGTH 25 & LOCAL DATA$,MOREDATA$
LENGTH 5.2 & LOCAL X
.
.
.
DATA$ = "abc123def456ghi789jkl"
MOREDATA$ = "This is more data"
X = 22.5

Print (Init Input Data)

Input @(10,10),DATA$,10;_
      @(10,12),MOREDATA$;_
      @(10,14),X

 

In this example, three values are set to their initial values, and then the (Init Input Data) mnemonic is issued. When the INPUT statement is executed, the initial values are displayed. 

Note that a length override of 10 is applied to DATA$, which displays the first 10 characters of the input field. (The input data will scroll horizontally if the cursor moves beyond the bounds of the field's entry area.) 
 

(Insert Off)

 
Mnemonic:   (Insert Off)  
Discussion:  This mnemonic turns the insert key off.  
Example:  a. 100 FORMAT (Insert Off)
   .
   PRINT (0,100)

b. PRINT (0) (Insert Off

(Insert On)

 
Mnemonic:   (Insert On)  
Discussion:  This mnemonic turns the insert key on.  
Example:  a. 100 FORMAT (Insert On)
   .
   PRINT (0,100)

b. PRINT (0) (Insert On)


==  (Invoke HELP) ==
 
Mnemonic:   (Invoke HELP)  
Hex equivalent:  "@0E01@"  
Discussion:  This mnemonic is used in conjunction with the NOVA system (i.e., the Comet Help System). 
The (Invoke HELP) mnemonic sets a flag within Comet. At the next INPUT statement in the program, this flag is examined; if the flag is on, Comet reads the #NOVA control file and takes the action specified in the "automatic help" record. 

The result is a "pop-up" help feature, where a help action will occur automatically at a given INPUT prompt without the operator pressing one of the NOVA function keys. 

The (Invoke HELP) control remains in effect only for the following INPUT statement (i.e., the auto help flag is turned off when automatic help is invoked). To use this feature repeatedly, you must use the (Invoke HELP) mnemonic repeatedly. 
 
Example:  PRINT (0) (Invoke HELP)   ! Set the automatic help flag
.
INPUT (0) WHATEVER$       ! Perform the automatic help action
                          ! as specified in the #NOVA control
                          ! file, then return to this INPUT
                          ! statement