Click above to get retro games delivered to your door ever month!

DSETWINDOW()

Syntax:     DSETWINDOW([<expL>])


Arguments:  <expL> controls whether the output of external programs or
            user-defined functions should also be relative to the "window"


Returns:    A logical value.
            The actual setting of the switch prior to resetting.  If <expL>
            is (.T.) then all output will be "guided" into the window,
            if (.F.), the output will be on the physical screen (window 0),
            regardless of whether or not a window is open.

Usage:      DSETWINDOW() is used to control whether only the screen
            output of Clipper, or all outputs (including the low-level
            user-defined functions and DOS programs that are RUN
            within Clipper) are required to appear in a window.  This
            function can be used to switch off the window functions
            temporarily, enabling sub-programs you may have for
            manipulating the screen to be mixed with the Clipper Tools
            One window functions.

Note:       The standard setting for DSETWINDOW() is TRUE, i.e., all
            program output not writing directly to the screen RAM is
            relative to the window that is active.

            Clipper screen output is always written in a window, provided
            that one is open and active.  Only screen output of external
            routine, like C or Assembler user-defined functions are
            affected.  Clipper Tools One functions will in this case also
            be considered "external" since they are written in Assembler.

            If the window related output is switched on (.T.) with
            DSETWINDOW(), a change in the cursor position in an external
            module or program will also affect the cursor position in
            Clipper.  Set DSETWINDOW() to (.F.) if this characteristic
            is not required.

            If DSETWINDOW() is set to (.F.) use SETRC() to change the
            Clipper cursor position.

            Three of Clipper Tools One functions ignore this switch
            altogether, since they operate directly with screen video
            RAM; SCREENFILE(), FILESCREEN() and SHOWTIME().

            A public variable of the tools is available to program your
            own routine in C or Assembler to affect the DSETWINDOW()
            switch, which can be addressed as follows:


            EXTRN     _WINDOW:WORD

            MOV       _WINDOW,0           ;window functions from all
                                          ;other values will switch on

            Function 19 (13h, write string) or the interrupt 16 (10h,
            video), which is normally only available on ATs will also be
            available on PCs if the switch is set to (.T.).

Library:    CT1.LIB


--------------------------------- Example ------------------------------

Examples:   * The output of other programs should also be
            * redirected to the selected window.

            DSETWINDOW(.T.)