From Wikibooks, open books for an open world
Jump to navigation Jump to search

FLUSHWINDOWBUFFER statement[edit | edit source]

FLUSHWINDOWBUFFER[edit | edit source]

Statement[edit | edit source]

✔ Appearance ✔ Standard ✔ Console

Syntax[edit | edit source]

FLUSHWINDOWBUFFER [{wRef | {_FBAutoFlushOff |_FBAutoFlushOn}]

Revised[edit | edit source]

April 2003 (Release 8)

Description[edit | edit source]

Under OS X, all drawing to a window is intercepted and stored ("buffered") by the Window Server. The Window Server normally transfers the drawing to the screen only when your program executes a HANDLEEVENTS statement. You can force an early update with FLUSHWINDOWBUFFER.

If wRef is omitted, or is 0, the current output window is flushed by the OS X Window Server. If wRef is non-zero, window wRef is flushed.

The default behavior of the FutureBASIC runtime is to flush the current output window each time a PRINT statement is performed. You can control that behavior: FLUSHWINDOWBUFFER _FBAutoFlushOff will turn off the automatic flushing. You still can force the flushing for a specific window with FLUSHWINDOWBUFFER wRef. FLUSHWINDOWBUFFER _FBAutoFlushOn will restore the automatic flushing.

The FLUSHWINDOWBUFFER command has no effect unless the program is running under OS X.


// In this example, there is no HandleEvents,
// and so FlushWindowBuffer is needed to
// make the drawing visible under OS X.

PLOT 0,0 TO 500,500


UNTIL FN BUTTON // wait for mouse-down