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 given graphic object (optionally also the given instance) on 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 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 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 the particular instance of graph in 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