Functions and Directives Functions and Directives

Function DispOutAt() Foundation

Displays a value on the screen without changing the cursor position.

Syntax
DispOutAt( <nRow>, <nCol>, <Expression>, ;
           [<cColor>], [<oWindow>] ) --> NIL
Parameters
<nRow>
<nRow> is an integer numeric value in the range of 0 to MaxRow(). It determines the row position for the output on screen.
<nCol>
<nCol> is an integer numeric value in the range of 0 to MaxCol(). It determines the column position for the output on screen.
<Expression>
<Expression> is an expression whose value is displayed.
<cColor>
The optional argument <cColor> defines the color for the display of <Expression>. If this argument is not included, <Expression>is displayed in the default color of the system colors defined with SetColor().
<oWindow>
The parameter <oWindow> optionally specifies the window where the display should appear. It defaults to the return value of SetAppWindow(). If a window object is specified for<oWindow>, it must be suitable for text-mode output (e.g. XbpCrt() or VCrt() window).
Return

The return value of DispOutAt() is always NIL.

Description

DispOutAt() displays the value of an individual expression at the indicated row and column position on the screen or in the active window without changing the current position of the screen cursor. It is a simple output function which only displays values on the screen. The output device set with SET DEVICE is ignored by DispOutAt().

Examples
DispOutAt() 
// In the example, a thread is started whose output is 
// displayed in the upper right corner of the screen. 
// The value of the function Time() is displayed once 
// per second using DispOutAt(). The cursor remains 
// at its position in the GET input field for input 
// using READ. 

PROCEDURE Main 
   LOCAL bBlock, cVar := Space(10) 

   bBlock := {|| DispOutAt(0, MaxCol()-7, Time(), "W+/B") } 
   SetTimerEvent( 100, bBlock ) 

   SetCursor(1) 
   @ 10,10 SAY "Input:" GET cVar 
   READ 

RETURN
Feedback

If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.