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 | ||||
|---|---|---|---|---|
| ||||
%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.
...
- To set a graphic object property (visibility in this case). It is a so-called called Control function.
- 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.
...
The first parameter of GET and SET functions is the value of the
| Kotva | ||||
|---|---|---|---|---|
|
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.
...
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:
...
- %HI_EDADebugCalcFunctionRec
- %HI_EDADebugClose
- %HI_EDADebugOpen
- %HI_EDADebugVectorRec
- %HI_GetActiveTab
- %HI_GetBackColor
- %HI_GetBackColor2
- %HI_GetDistX
- %HI_GetDistY
- %HI_GetEnable
- %HI_GetFontStyle
- %HI_GetForeColor
- %HI_GetMandatoryMode
- %HI_GetMetadata, %HIX_GetMetadata
- %HI_GetMetadataMulti, %HIX_GetMetadataMulti
- %HI_GetPaintEffects
- %HI_GetPosX
- %HI_GetPosY
- %HI_GetSizeX
- %HI_GetSizeY
- %HI_GetText
- %HI_GetTextColor
- %HI_GetValue
- %HI_GetVisible, %HIX_GetVisible
- %HI_LockUpdate
- %HI_SetBackColor
- %HI_SetBackColor2
- %HI_SetBmp
- %HI_SetBmpFile
- %HI_SetBmpTheme
- %HI_SetEnable
- %HI_SetFocus
- %HI_SetFontStyle
- %HI_SetForeColor
- %HI_SetDistX
- %HI_SetDistY
- %HI_SetDraggable
- %HI_SetDragRangeX
- %HI_SetDragRangeY
- %HI_SetMandatoryMode
- %HI_SetMetadata, %HIX_SetMetadata
- %HI_SetMetadataMulti, %HIX_SetMetadataMulti
- %HI_SetPaintEffects
- %HI_SetPosX
- %HI_SetPosY
- %HI_SetSizeX
- %HI_SetSizeY
- %HI_SetText
- %HI_SetTextColor
- %HI_SetToolTipText
- %HI_SetValue
- %HI_SetVisible
- %HI_SetWinCtrlBmp
...
| Kotva | ||||
|---|---|---|---|---|
|
...
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 | ||
|---|---|---|
| ||
...