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 %HI_.

For example:

%HI_SetVisible(_Button1, @FALSE)

or

BOOL _visible
 _visible := %HI_GetVisible(_Button1)

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.

The examples imply that functions are used in two contexts:

  1. To set a graphic object property (visibility in this case). It is a so-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 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 reference variable of the particular graphic object. It is usually the reference variable (e.g. Button1). When such a function is executed, 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 can control only some types of graphic objects. If the script interpreter 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.


%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

Graphic objects manipulation functions:


List box manipulation functions:


List box and Tree view manipulation functions:


Tree view manipulation functions:


List box, Tree view and Browser manipulation functions:


Text entry field and List box manipulation functions:


Text entry field manipulation functions:


Text entry field -RichEdit manipulation functions:


Browser (displayer) manipulation functions:


Report(displayer) manipulation functions:


Graph (displayer) manipulation functions and actions:


Graph and Picture/Component (displayer) manipulation functions:


Graph (displayer) and XY Graph manipulation functions:


XY Graph manipulation functions:


Logging manipulation functions:


Alarms manipulation functions:


WebFrame (displayer) manipulation functions:


Functions supporting Drag&Drop:


Other functions:


Note

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

Related pages:

Active picture - functions
Graphic objects

Napíšte komentár