Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

Graphic object manipulation functions

For the purpose of communication with individual graphic objects, there are implemented functions, which look like functions commonly used in the expressions of eval tags or scripts. Function names are created by the prefix prefix %HI_.

For example:

Blok kódu
languageesl
themeRDark
%HI_SetVisible(_Button1, @FALSE)

...

The first example controls the visibility of the graphic object with the reference variable _Button1.
The second example detects the current state of the graphic object visibility.

...

  1. To set a graphic object property (visibility in this case). It is a so-called called Control function.
  2. To detect the state of the graphic object property.

Functions to set properties of graphic objects do not get values and they can not be used in expressions. Functions to detects detect the state (value) of graphic object properties get values and they can be used in expressions.

Let's call the first set of functions GET functions and the second set SET functions.

The first parameter of GET and SET functions is the value of the

Kotva
refid
refid
reference variable of the particular graphic object. It is usually the reference variable (e.g. Button1). When such a function is executed, there it is always checked whether the graphic object (connected to the reference variable) exists. If the graphic object doesn't exist, the script interpreter generates the error _ERR_UNKNOWN_REFID, which is standardly processed by the error handler (see the action ON ERROR).

Each function is able to can control only some types of graphic objects. If the script interpreter detect detects an illegal use of a function for a specific type of graphic object during the function execution, the interpreter generates the error _ERR_INVALID_REFID_TYPE.


Kotva
hix_funkcie
hix_funkcie
%HIX_  functions

Some %HI_ functions are also available in the %HIX_ version. These functions are able to redirect the function executing to another picture (through the first two parameters).

Example: Function %HI_ClosePicture() is available in %HIX_ClosePictur (IN HBJ _picHBJ, IN INT _KInstance). %HI_ClosePicture closes the picture in which it has been called. %HIX_ClosePicture closes the picture defined by HOBJ (internal object identifier) and instance. Meaning of HOBJ and instance is the same as it is in the case of RPC CALL (parameters objIdent and instanceExpr).

If function %HIX_ is applied, the ESL script must be implemented to the picture (it must be an Active picture).


Types of functions:

List of graphic object manipulation functions

...

...

...


Kotva
report
report
Report(displayer) manipulation functions:

...

Kotva
graf_schema
graf_schema
Graph and Picture/Componet (displayer) manipulation functions:

...


Kotva
alarmy
alarmy
Alarms manipulation functions:

...


Note

  • Functions, whose name names begin with the string %HI_Get... get values and they can be used in expressions.
  • The other functions are the so-called called  Control functions.
Info
titleRelated pages:

Active picture - functions
Graphic objects

...