tcxlhist.doc

就一个字强.很不错,希望大家能喜欢.这是我朋友发给我的

                emstotal   - returns the total number of EMS pages on the
                             system
                emsver     - returns the current EMS version
                emswrite   - writes bytes to an EMS page(s)
                expmem     - determines the amount of expanded memory on the
                             system in kilobytes
                strcode    - encodes/decodes a string
                strins     - inserts one string into another
                strrol     - rotates string x characters left, characters wrap
                             around
                strror     - rotates string x characters right, characters wrap
                             around
                strshl     - shifts string x characters left, characters 'drop
                             off' of the string and spaces are added
                strshr     - shifts string x characters right, characters 'drop
                             off' of the string and spaces are added
                wcloseall  - closes all open windows
                wcopy      - creates a new window by copying the active window

            The following functions were changed to check for the existence of
            any active windows.
                wclear   - now returns a return code (see TCXL.H)
                wclose   - now returns a return code (see TCXL.H)
                wclreol  - now returns a return code (see TCXL.H)
                wgetc    - now returns a 0 if error
                wgetchf  - now returns a 0 if error


                                      5    
                wgets    - now returns a return code (see TCXL.H)
                wgetsf   - added an additional possible error code (see TCXL.H)
                wgotoxy  - added an additional possible error code (see TCXL.H)
                wmove    - added an additional possible error code (see TCXL.H)
                wprintc  - added an additional possible error code (see TCXL.H)
                wprints  - added an additional possible error code (see TCXL.H)
                wputc    - now returns a return code (see TCXL.H)
                wputs    - now returns a return code (see TCXL.H)
                wputsf   - now returns a return code (see TCXL.H)
                wscroll  - now returns a return code (see TCXL.H)
                wsize    - added an additional possible error code (see TCXL.H)
                wtextattr - now returns a return code (see TCXL.H)

            The following functions were changed to recognize the '\r', '\7',
            and the '\t' control characters.
                wputc
                wputs
                wputsf

            wprints() was changed so it will not recognize the '\n' control
            character and it will no longer scroll the window when at the end
            of it.  For these purposes, use the wputs() function instead.

            ssave() and srestore() were converted to assembly language for
            optimized performance.


Version 2.1:
            Added new functions.  See TCXL.DOC for full descriptions and
            examples.
                wclreol  - clears to the end of the active window's line
                wgetc    - gets a character from the keyboard within active
                           window
                wgetchf  - gets a character from the keyboard within active
                           window, only allows characters from a given list
                wgets    - gets a string from the keyboard within active window
                wgetsf   - gets a string from the keyboard within active
                           window, limits input to specified length
                wputsf   - prints a string in active window, formatting width
                           of output
                wsize    - adjusts the size of the active window

            Expanded the window record structure (_wrecord) to include more
            information useful for window management.  See TCXL.H for the
            layout of the _wrecord structure.

            Modifed some of the existing functions.
                getchf  - optimized for better performance
                wactiv  - modified to work with new window record
                wclear  - modified to work with new window record
                wgotoxy - modified to work with new window record
                wmove   - modified to work with new window record, now returns
                          a zero for no error or one of the return codes in
                          the TCXL.H file
                wopen   - modified to work with new window record
                wprintc - modified to work with new window record
                wprints - modified to work with new window record


                                      6    
                wputc   - modified to work with new window record, now returns
                          type void, fixed a bug which caused it not to work
                          sometimes
                wputs   - changed return type to void and optimized for better
                          performance, also now recognized the backspace '\b'
                          character
                wscroll - modified to work with new window record


Version 2.0:
            Added a new window task manager which simpilfies use of windowing.
            Several of the windowing functions' syntax have been changed and
            some have been added.  See TCXL.DOC for full descriptions and
            examples.
                wopen     - now returns a window handle instead of a pointer
                wclose    - closes the currently active window
                wactiv    - new function, activates a currently open window
                            using the window handle returned by wopen()
                wclear    - clears the currently active window
                wgotoxy   - plots cursor coordinates in currently active window
                wmove     - moves currently active window to a new location
                wprintc   - prints a character in the active window, now
                            returns a 1 if cursor placement error occurred
                wprints   - prints a string in the active window, now returns a
                            1 if cursor placement error occurred, now provides
                            wrap-around and scrolling, now also will recognize
                            line feed ('\n') characters in string
                wputc     - prints a character in currently active window at
                            current cursor location, uses attribute set by the
                            wtextattr() function
                wputs     - prints a string in currently active window at the
                            current cursor location, uses attribute set by the
                            wtextattr() function
                wscroll   - scrolls text in the currently active window
                wtextattr - sets the default text attribute for several of the
                            windowing functions

            Deleted the wswap() and wswapx() functions as wactiv() takes their
            place.

            Added global variables to assist in managing the windows.
                _wrecord   - an array of structures that contain window handles
                             and window buffer pointers.  See TCXL.H
                _wcurrent  - contains the array subscript of the window that is
                             currently active
                _wtextattr - contains the default window text attribute

            Added several new functions.  See TCXL.DOC for full descriptions
            and examples.
                clockcal - checks for presence of clock/calendar card in XT
                extmem   - determines the amount of AT extended memory
                getktot  - gets total size of a disk drive in kilobytes
                machid   - returns the ROM signature byte
                scrndump - sends contents of text screen to printer
                timer    - returns the value of the BIOS timer

            Revised/changed several functions.


                                      7    
                biosver  - now returns pointer to static string instead of
                           allocated string, so DON'T use free() on the
                           string.  Also now independent of Turbo C library.
                box      - fixed a bug that caused this function to misbehave
                           when using the small memory model
                boxd     - fixed a bug that caused this function to misbehave
                           when using the small memory model
                spc      - optimized performance
                strleft  - fixed a minor bug occurring on allocation error
                strmid   - fixed a minor bug occurring on allocation error
                strright - fixed a minor bug occurring on allocation error
                waitkey  - now returns the key pressed

            Borland recently released Turbo C Version 1.5.  Included in their
            standard library now are the functions clreol(), delay(), gotoxy(),
            and sound().  These functions are similar but not identical to
            the TCXL functions of the same name.  To provide compatibility
            with the new Turbo C 1.5 library, I have renamed the affected TCXL
            functions.
                clreol  ->  clreol_
                delay   ->  delay_
                gotoxy  ->  gotoxy_
                sound   ->  sound_

            Also in Turbo C 1.5, Borland included macros for the text mode
            colors in GRAPHICS.H.  To provide compatibility with Turbo C 1.5,
            many of the macros for colors in the TCXL.H file have been renamed.
                YELLOW      ->  BROWN
                WHITE       ->  LGREY
                IBLACK      ->  DGREY
                IBLUE       ->  LBLUE
                IGREEN      ->  LGREEN
                ICYAN       ->  LCYAN
                IRED        ->  LRED
                IMAGENTA    ->  LMAGENTA
                IYELLOW     ->  YELLOW
                IWHITE      ->  WHITE
                _YELLOW     ->  _BROWN
                _WHITE      ->  _LGREY


Version 1.6:
            Added a new function.  See TCXL.DOC for description.
                tabstop - calculates the next tab stop from current cursor
                          location

            Fixed a problem in the sound() function that caused it not to work
            to work in some machines.

            Optimized performance of several functions.
                boxd
                delay
                filld
                getchf
                printcd
                printsd
                sound


                                      8    
                strsetsz
                wclear
                whide
                wmove
                wscroll


Version 1.5:
            Added several new functions.  See TCXL.DOC for full descriptions
            and examples.
                clrwin  - clears a window of the CGA screen
                setattr - sets the attribute of character under cursor
                wclear  - clears an open window
                whide   - hides an open window
                wgotoxy - plots cursor coordinates within an open window
                wprintc - prints a character within an open window
                wprints - prints a string within an open window
                wscroll - scrolls text within an open window
                wswap   - swaps 2 windows, the back becomes the front
                wswapx  - swaps 3 windows, the back becomes the front
                wunhide - reveals a previously hidden open window

            Revised/changed several functions.  See TCXL.DOC for full
            descriptions and examples.
                getchf  - now returns character typed but still provides
                          automatic checking for the Escape key
                lprintc - changed 'ch' parameter in prototype to type 'int'
                revattr - added a 'count' parameter
                striocc - changed 'ch' parameter in prototype to type 'int'
                strocc  - changed 'ch' parameter in prototype to type 'int'
                wprintc - changed 'ch' parameter in prototype to type 'int'

             Optimized performance of several functions.
                box
                boxd
                fill
                getchf
                gotoxy
                printc
                prints
                prompts
                ssave
                strdel
                stridel
                wmove
                wopen


Version 1.0:
            Initial release.









                                      9