The Erase method deletes all of the graphics and annotations within a graphic window, but does not destroy the window itself. This method is only available on the window object. All other properties of the window object remain unchanged after the erase.

Note: After this method is called, any references to graphics objects will be invalid, and should not be used. The only graphics object that will remain valid is the window itself.

Example


 
p1 = PLOT(/TEST)
 
; Retrieve the plot's window object
w = p1.WINDOW
 
; Note that p1 will no longer be valid
w.Erase
 
; Add a new plot to the same window
p2 = PLOT(/TEST, /CURRENT)

Syntax


window.Erase [, COLOR=color]

Arguments


None

Keywords


COLOR

Set this keyword to a string or RGB vector giving the window's background color. Setting this keyword is equivalent to setting the BACKGROUND_COLOR property on the window object. If this keyword is not set then the window's current color is unchanged.

Version History


8.2

Introduced

See Also


Close Method, Show Method, GETWINDOWS, WINDOW