[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
UNTEXTWIN()
Replaces an area of characters from a region of the screen
------------------------------------------------------------------------------
Syntax
UNTEXTWIN(<nTopLine>, <nLeftColumn>, <nBottomLine>,
<nRightColumn>,
<cReplacementCharacter|nReplacementCharacter>,
[<cInitialCharacter|nInitialCharacter>],
[<cEndCharacter|nEndCharacter>]) --> cNull
Arguments
<nTopLine> Designates the line for the upper-left corner of the
area.
<nLeftColumn> Designates the column for the upper-left corner of
the area.
<nBottomLine> Designates the line for the bottom-right corner of
the area.
<nRightColumn> Designates the line for the bottom-right column of
the area.
<cReplacementCharacter|nReplacementCharacter> Replaces each
character within the window, with the exception of those within the
range of <cInitialCharacter|nInitialCharacter> and
<cEndCharacter|nEndCharacter>.
<cInitialCharacter|nInitialCharacter> Designates the beginning of
the bracketed area. The character can be number in the range of 0 to
255, or the character string type. The default value is 176.
<cEndCharacter|nEndCharacter> Designates the end of the bracketed
area. The character can be number in the range of 0 to 255 or the
character string type. The default value is 223.
Returns
UNTEXTWIN() always returns a null string.
Description
Use UNTEXTWIN() to delete particular character from within a screen
area. You can bracket off a specific area of characters. This area
begins with <cInitialCharacter|nInitialCharacter> and ends with
<cEndCharacter|nEndCharacter>. The preset values have bracketed out
characters 176 to 223 (the graphics characters). This allows you to
clear a screen, but retain the boxes.
The designated area can even "double back"; EndCharacter could be
smaller than Initial Character. In this case, the area stretches from
the larger value to 255 and, inclusive of 0, to the smaller value. You
might say these two areas are designated.
Examples
. Clear the screen, with the exception of the boxes. Since no
range is specified, 176 to 223 are bracketed out:
UNTEXTWIN(0, 0, 24, 79, " ") // ""
. Clear all characters, with the exception of uppercase letters
(65-90). A numeric BLANK is designated as a clear character:
UNTEXTWIN(0, 0, 24, 79, 32, 65, 90) // ""
. Double back on an area. All characters with the exception of
uppercase letters are deleted:
UNTEXTWIN(0, 0, 24, 79, 255, 91, 64) // ""
See Also:
CLEARWIN()
CLWIN()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson