GRAPHIC ATTACH statement

Purpose

Select the graphic target (window, control, or bitmap) on which future drawing operations will take place.

Syntax

GRAPHIC ATTACH hWin???, id& [, REDRAW]

Remarks

The selection remains in effect until another GRAPHIC ATTACH statement is executed, or the graphic target is deleted.  All PowerBASIC graphical displays are persistent; they will be automatically redrawn even if minimized or temporarily covered by another window.

hWin???

graphic window, bitmap, or control to be used with GRAPHIC statements.

id&

Handle of the graphic window, control, or bitmap to be used with GRAPHIC statements. If a GRAPHIC CONTROL is being attached then hWin???,  is the handle to the window that contains the graphic control, as assigned with the CONTROL ADD GRAPHIC statement.

REDRAW

Optional parameter that causes all drawing statements to be buffered until a GRAPHIC REDRAW statement is executed, or the operating system chooses to update the target window.  Without REDRAW, all graphical statements (Line, Box, etc.) are performed immediately.  However, in certain intensive drawing operations, it may be preferable to delay the display until a number of statements have been performed.  In some cases, this can improve the overall performance dramatically.

See also

CONTROL ADD GRAPHIC, GRAPHIC BITMAP LOAD, GRAPHIC BITMAP NEW, GRAPHIC WINDOW