Download - True BASIC

186 True BASIC Language System
If the font size is a negative number, the previous size will not be changed.
You can find out what fonts are available by calling TC_FontsAvailable.
The default colors are black (-1) on white (-2) , with a black border. If you wish to specify other colors, use
CALL TC_Txed_SetColor (cid, forecolor, backcolor, bordercolor)
The three colors are numbers that refer to the color mix table currently in use (see Chapter 13 “Graphics”). If you
specify a number less than -2, the previous value of that color will not be changed.
Cut, Copy, and Paste with Text Editors
True Controls provides for the usual cut, copy, and paste functions.
CALL TC_Txed_Cut (txed)
CALL TC_Txed_Copy (txed)
CALL TC_Txed_Paste (txed)
In each case, it is assumed that text has been selected by the user, so that it shows in reversed color. Cut removes the
text from the text editor and places it on the system clipboard. Copy just places the selected text on the system clipboard.
Paste inserts the contents of the system clipboard at the insertion point, indicated by the insertion cursor; if
text has been selected, paste replaces the selected text with the contents of the clipboard.
If you have included menus in the window that contains the text editor, you may wish to create menu items for cut,
copy, and paste. You can then use the TC_Txed_SetCutCopyPaste routine to have True Controls intercept
those menu items and call the appropriate subroutine above. The format for this routine is:
CALL TC_Txed_SetCutCopyPaste (wid, cutm, cuti, copym, copyi, pastem, pastei)
For cutm and cuti, you supply the appropriate subscripts for the menu and item choice for Cut, and so on for
the remaining arguments. True Controls keeps track of a text edit control attached to a particular window, and
invokes appropriate cut, copy, or paste operations. Warning: the text edit control must be attached, and there can
be no more than one such attached text edit control.
Find Text in Text Editors
True Controls includes a search utility that works with either wrapped or unfolded text.
CALL TC_Txed_Find (cid, case, word, key$, par, ln1, ch1, ln2, ch2, found)
If you wish the search to be case-sensitive, set the variable case to 1; otherwise, set it to 0. If you wish the search
to concentrate on entire words, set the variable word to 1; otherwise, set it to 0.
The search key must be supplied in the string variable key$. The next five arguments specify where the search
should begin. (Note that if the text is not wrapped, then the line number is always 0. Also note that paragraph,
line, and character numbering start with 0.) To start the search at the beginning of the text, set all five values to
0.
If the search is successful, then the argument found will have the value 1. The matched text will be selected in
the text editor, and its position returned in the five arguments. If the search is not successful, found will have the
value 0, and the prior values of the five arguments will not be changed.
Note that the matched text must be contained within a single paragraph, whose number is returned in par.
Selecting Text in Text Editor
Finally, you may wish to select or highlight certain text in the text editor. For example, you may wish to highlight
certain portions of a help file. This can be done with
CALL TC_Txed_SetSelection (cid, par1, ln1, ch1, par2, ln2, ch2)
You must, of course, determine the correct values of the starting and ending paragraphs, lines, and characters.
And remember that paragraph, line, and character numbering starts with 0.