<<

Contents

Search

>>

 

REMOVE_PICTURE

 

 

Function

 

 

Syntax:

REMOVE_PICTURE(<Image Name>[,<Row>,<Column>[,<Handle>]])

 

<Image Name>

= <STRING-EXPRESSION>

<Row>

= <NUM-EXPRESSION>

<Column>

= <NUM-EXPRESSION>

<Handle>

= <NUM-EXPRESSION>

 

 

Meaning:

Removes images from the screen.

 

If <Row> and <Column> are specified, only the picture on this position is removed. If <Row> = 0 and <Column> = 0, all pictures with the name <Image Name> are deleted.

 

<Handle> specifies in which window the images are deleted. <Handle> can contain the window depth or the handle of a split window or a WINDOWCALL window. If the parameter <Handle> is missing, the images are deleted in the current window.

 

REMOVE_PICTURE returns the result 7500 if no picture has been found, otherwise 0.

 

Parameter:

Image Name

Defines the name of the picture to be deleted. If the empty string "" is specified, all pictures in the current window are deleted.

 

Row

Defines the row position of the picture. If <Row> = 0, all pictures whose <Image Name> and <Column> correspond are deleted.

 

Column

Defines the column position of the image. If <Column> = 0, all pictures whose <Image Name> and <Row> correspond are deleted.

 

Handle

Window depth or handle of a split window or handle of a WINDOWCALL Window

 

 

Sample:

H% = REMOVE_PICTURE("Photo.gif")

IF H% <> 0

THEN … Error …

ENDIF

 

See also:

LOAD_PICTURE

MOVE_PICTURE