CLOSE action

Function

Closing of a graph, graphic picture, or composition.

Declaration

CLOSE grObjIdent [INSTANCE instanceExprInt]

or

CLOSE grObjIdent ON procIdent [INSTANCE instanceExprInt]

or

CLOSE grObjIdent ON ALL [INSTANCE instanceExprInt]

or

CLOSE DIRECT

Parameters

grObjIdent	in	Reference to an object of Graph, Picture or Composition types.
procIdent	in	Identifier of a Process type object (Human Interface).
instanceExprInt	in	Expression of Int type, which specifies the object instance number.

Description

The action will close a given graphic object (optionally also the given instance) on a specified console (if not declared, then on SELF.HIP) or on all running consoles.

Action with the DIRECT clause is permitted only for:

- the script of the active picture - the action closes the active picture,
- the script of server event opened by an OPENEVENT action
- - closes the script (

WARNING:

- next actions may not be executed - so it is recommended to put the

CLOSE DIRECT

action at the end of RPC procedure).

Examples

Closing a graph in the process SELF.HIP

 BEGIN
  ALIAS _newGraph
  INT _newGraphHBJ
  SET _newGraph AS D.graf
  IF _newGraph\HBJ = 0 THEN
  ELSE
   OPEN _newGraph ; opening a graph in SELF.HIP process
   DELAY 2[s]
   CLOSE _newGraph ; closing a graph in SELF.HIP process
  ENDIF 
 END

Closing an instance of a graph in all HIP processes

 BEGIN
  ALIAS _newGraph
  INT _newGraphHBJ
  SET _newGraph AS D.graf
 
  IF _newGraph\HBJ = 0 THEN
  ELSE
    OPEN _newGraph ON ALL INSTANCE 0 ; opening the first instance
   OPEN _newGraph ON ALL INSTANCE 1 ; opening the second instance
    DELAY 2[s]
    CLOSE _newGraph ON ALL INSTANCE 1 ; closing the second instance
  ENDIF 
 END

Closing aparticular instance of a graph in the HIP process

 BEGIN
  ALIAS _newGraph
  INT _newGraphHBJ
  SET _newGraph AS D.graf

  IF _newGraph\HBJ = 0 THEN
  ELSE
   OPEN _newGraph ON srvskol1v.HIP INSTANCE 0 ; opening the first instance
   OPEN _newGraph ON srvskol1v.HIP INSTANCE 1 ; opening the second instance
   DELAY 2[s]
   CLOSE _newGraph ON srvskol1v.HIP INSTANCE 1 ; closing the second instance
  ENDIF 
 END

Related pages:

Script actions