Mnemonics "T"

From CometWiki

Latest revision as of 21:13, 15 January 2010

(Text)

 
Email Mnemonic:   (Text=string-argument)  
Discussion:  The (Text) mnemonic may be used to specify body text in addition to whatever is written to the email printer. Depending on your email client, for html printers body text will either appear in an attachment, since it is usual for HTML to appear as the main body of the email, or it will be appended following the html content. For PDF printers, this text will be the main body of the email and the PDF will appear as an attachment. For text printers, the body text will appear just before the printer output.  
Example:  OPEN (1) "LEH"
PRINT (1) (Text="Attached is confirmation of your order")

 
 Read about other Email Mnemonics  

(TextOut)

Mnemonic: (TextOut = x, y);printable-text

Discussion: Prints the specified printable-text at the location specified by x and y. Character origins are at the upper-left corner of the character cell. By default, the current position is not used or updated by the function.

If an application needs to update the current position when it calls TextOut, the application can call the SetTextAlign member function with Flags set to TA.UPDATECP.

When this flag is set, Windows ignores the x and y parameters on subsequent calls to TextOut, using the current position instead.

History: This mnemonic is valid in Comet98 and greater

(TM)

 
Mnemonic:   (TM)  
Hex equivalent:  "@0C@"  
Discussion:  Transmit mark. 
The (TM) control code places a transmit mark character at the current cursor position. The transmit mark is automatically displayed in suppressed background (invisible) mode and occupies one space on the video screen. 

When the Tab, Return, or Enter key is pressed and the cursor advances past a transmit mark, the video device transmits to the host computer all foreground data between the last transmit mark and the previous transmit mark on the screen. 

Thus, transmit marks form delimiters for block data transmission. One transmit mark should be placed at the beginning of the data block to be sent to the host computer, and another transmit mark should be placed at the end of the data block. Cursor movement between the two transmit marks does not result in data transmission to the host system. Only when the ending transmit mark is crossed is the data block sent to the host system. 

This control code may also include a positioning statement to place a transmit mark at a specific point on the screen. 

See Transmit Stop (TP). 
 
Example:  100  FORMAT  (CS);_                   ! clear screen
             (EN);_                   ! enter normal mode
             (SB);_                   ! start background
             "CUSTOMER NUMBER:",@(0,5);_   ! prompt
             (TM);_                        ! transmit mark
             (SF);"     ";_           ! foreground spaces
             (TM);_                   ! transmit mark
             @17,5)                   ! move cursor
             .
             .
             .
             PRINT (0,100)
             INPUT (0) CUSTNUM$

This example combines several video control codes to demonstrate the basic function of the transmit mark. The FORMAT statement starts by clearing the screen (using the (CS) control code) and entering normal mode (using the (EN) control code). 
Then, the (SB) control code is used to start background display mode. A prompt is displayed starting at column 0, row 5. Following the prompt, a transmit mark is displayed. 

Next, the (SF) control code is used to start foreground display mode (for a data entry field), and five blank spaces are displayed. Following these spaces, another transmit mark is displayed. 

The final element in the FORMAT statement moves the cursor to column 17, row 5, which is the left-most character in the data entry field. This data entry field is made up of five foreground blanks surrounded by transmit marks. When the second transmit mark is crossed by an operator action or forced transmit from the program itself, the data in the data entry field will be sent to the host computer. 

(To)

 
Email Mnemonic:   (To=string-argument)  
Discussion:  The (To) mnemonic is used to specify one or more recipients for your email message.  
Example:  OPEN (1) "LEH"
PRINT (1) (To="gina@@signature.net")
PRINT (1) (To="jim<jim@@signature.net>")

 
 Read about other Email Mnemonics   

(TP)

 
Mnemonic:   (TP)  
Hex equivalent:  "@0409@"  
Discussion:  Transmit stop mark. 
The (TP) control code places a transmit stop character at the current cursor position. This control functions exactly like a transmit mark, except that the operator cannot move the cursor to a previous (above or to the left of) position on the screen. See Transmit Mark (TM). 
 
Example:  100  FORMAT  (CS);_                   ! clear screen
             (EN);_                   ! enter normal mode
             (SB);_                   ! start background
             "CUSTOMER NUMBER:",@(0,5);_   ! prompt
             (TP);_                        ! transmit stop mark
             (SF);"     ";_           ! foreground spaces
             (TP);_                   ! transmit stop mark
             @17,5)                   ! move cursor
             .
             .
             .
             PRINT (0,100)
             INPUT (0) CUSTNUM$

This example combines several video control codes to demonstrate the basic function of the transmit stop mark. The FORMAT statement starts by clearing the screen (using the (CS) control code) and entering normal mode (using the (EN) control code). 
Then, the (SB) control code is used to start background display mode. A prompt is displayed starting at column 0, row 5. Following the prompt, a transmit stop mark is displayed. 

Next, the (SF) control code is used to start foreground display mode (for a data entry field), and five blank spaces are displayed. Following these spaces, another transmit stop mark is displayed. 

The final element in the FORMAT statement moves the cursor to column 17, row 5, which is the left-most character in the data entry field. This data entry field is made up of five foreground blanks surrounded by transmit stop marks. When the second transmit stop mark is crossed by an operator action or forced transmit from the program itself, the data in the data entry field will be sent to the host computer. 

(TR)

 
Mnemonic:   (TR)  
Discussion:  This mnemonic sets "transparent printing mode" (i.e., the printer driver does not append CR/LF to the end of each line).  
Example:  a. 100 FORMAT (TR)
   .
   OPEN (1) "LP1"
   PRINT (1,100)

b. OPEN (1) "LP1"
   PRINT (1) (TR)

(Transparent Color)

 
Mnemonic:  (TransparentColor = QCRTColor)  
Discussion:  Determines the QCRT field color that will be transparent to the underlying wallpaper. 
Where QCRTColor is: 

A QCRT field color ranging in value
from 0 to 15 (upper 4 bits of a
configured color).

or

TP.ALL	= 255  ! All colors are transparent
TP.FGND	= 254  ! The foreground field color is transparent
TP.BKGND = 253 ! The background field color is transparent
TP.ENTRY = 252 ! The entry field color is transparent
TP.CUR = 251   ! The current field color is transparent

 
Example:  Print (0) (ChangeColor = "@F0@");(CS)  ! Clear screen to desired transparent color
Print (0) (TransparentColor = TP.CUR)  ! Enable the transparent color