Za účelom komunikácie s jednotlivými grafickými objektmi sú implementované funkcie, ktoré sa podobajú na funkcie bežne používané vo výrazoch v počítaných bodoch alebo v skriptoch. Mená funkcií sú tvorené prefixom %HI_.
Napríklad:
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
%HI_SetVisible(_Button1, @FALSE) |
...
V prvom prípade ide o ovládanie viditeľnosti grafického objektu, ktorému je priradená referenčná premenná s menom _Button1. V druhom prípade ide o zisťovanie aktuálneho stavu viditeľnosti grafického objektu.
...
Pre prvú skupinu funkcií bude ďalej používané meno GET a pre druhú SET funkcie.
GET aj SET funkcie majú prvý parameter hodnotu
referenčnej premennej príslušného grafického objektu. Obyčajne je to priamo referenčná premenná (napríklad _Button1). Pri vykonávaní takejto funkcie vždy prebieha kontrola existencie príslušného grafického objektu (je zviazaný pripojením s referenčnou premennou). Ak takýto grafický objekt neexistuje, interpret skriptu generuje chybu _ERR_UNKNOWN_REFID, ktorá je ďalej štandardne spracovaná obsluhou chýb (viď akcia ON ERROR).Kotva refid refid
Určitými funkciami je možné ovládať len niektoré typy grafických objektov. Ak pri vykonávaní funkcie interpret skriptu zistí jej nedovolené použitie pre určitý druh grafického objektu, generuje chybu _ERR_INVALID_REFID_TYPE.
| Kotva | ||||
|---|---|---|---|---|
|
Pre niektoré funkcie %HI_ existujú tzv. %HIX_ funkcie. Tie umožňujú presmerovať spracovanie funkcie v kontexte inej schémy, než v akom prebehlo jej volanie (prostredníctvom prvých dvoch parametrov).
Napríklad k funkcii %HI_ClosePicture() existuje %HIX_ClosePicture (IN HBJ _picHBJ, IN INT _KInstance). V prvom prípade je jej efekt taký, že zatvorí schému, v rámci ktorej bola volaná. V druhom prípade zatvorí schému, ktorá je určená HOBJ (interný identifikátor objektu) a inštanciou. Význam HOBJ a inštancie je rovnaký ako v prípade RPC CALL (parametre objIdent a instanceExpr).
Schéma, ktorá je riadená "z boku", musí mať implementovaný ESL skript (musí to byť Aktívna schéma).
Rozdelenie funkcií:
- Funkcie pre prácu s grafickými objektmi
- Funkcie pre prácu s Windows prvkami typu Zoznam a Strom
- Funkcie pre prácu s Windows prvkom typu Strom
- Funkcie pre prácu s Windows prvkami typu Zoznam a Strom a zobrazovačom typu Browser
- Funkcie pre prácu s Windows prvkom typu Vstup textu a Zoznam
- Funkcia pre prácu s Windows prvkom typu Vstup textu
- Funkcia pre prácu s Windows prvkom typu Vstup textu - RichEdit
- Funkcie pre prácu so zobrazovačom typu Browser
- Funkcie pre prácu so zobrazovačom typu ReportReport
- Funkcie a akcie pre prácu so zobrazovačom typu Graf
- Funkcia pre prácu so zobrazovačmi typu Graf alebo Schéma
- Funkcie pre prácu so zobrazovačom typu Graf alebo XY Graf
- Funkcie pre prácu so zobrazovačom typu XY Graf
- Funkcie pre prácu so zobrazovačom typu Monitorovanie
- Funkcie pre prácu so zobrazovačom typu Alarmy
- Funkcie pre prácu so zobrazovačom typu WebFrame
- Funkcie pre prácu so zobrazovačom typu iframe
- Funkcie podporujúce Drag & Drop
- Ostatné funkcie
Zoznam funkcií pre ovládanie grafických objektov
...
- %HI_EDADebugCalcFunctionRec
- %HI_EDADebugClose
- %HI_EDADebugOpen
- %HI_EDADebugVectorRec
- %HI_GetActiveTab
- %HI_GetBackColor
- %HI_GetBackColor2
- %HI_GetDistX
- %HI_GetDistY
- %HI_GetFontStyle
- %HI_GetForeColor
- %HI_GetLineWidth
- %HI_GetMandatoryMode, %HI_SetMandatoryMode
- %HI_GetMetadata, %HIX_GetMetadata
- %HI_GetMetadataMulti, %HIX_GetMetadataMulti
- %HI_GetPaintEffects
- %HI_GetPLineNumItems
- %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_SetDistX
- %HI_SetDistY
- %HI_SetDraggable
- %HI_SetDragRangeX
- %HI_SetDragRangeY
- %HI_SetEnable
- %HI_SetFocus
- %HI_SetFontStyle
- %HI_SetForeColor
- %HI_SetLineTerminator
- %HI_SetLineWidth
- %HI_SetMetadata, %HIX_SetMetadata
- %HI_SetMetadataMulti, %HIX_SetMetadataMulti
- %HI_SetPLineNumItems
- %HI_SetPaintEffects
- %HI_SetPosX
- %HI_SetPosY
- %HI_SetSizeX
- %HI_SetSizeY
- %HI_SetText
- %HI_SetTextColor
- %HI_SetToolTipText
- %HI_SetValue
- %HI_SetVisible, %HIX_SetVisible
- %HI_SetWinCtrlBmp
...
- %HI_AddTreeItem
- %HI_EditTreeViewItem
- %HI_ExpandItem
- %HI_FindItemData
- %HI_GetItemData
- %HI_GetTreeItemBackColor
- %HI_GetTreeItemTextColor HI
- %HI_ GetTreeItemTextColor
- GetTreeItemTooltip
- HI_GetTreeItemTextColor%HI_SetTreeItemBackColor
- %HI_SetTreeItemTextColor
- %HI_SetTreeItemTooltip
- %HI_SetItemData
- %HI_SetItemExpandable
- %HI_SetItemImage
...
| Kotva | ||||
|---|---|---|---|---|
|
...
| Kotva | ||||
|---|---|---|---|---|
|
| Kotva | ||||
|---|---|---|---|---|
|
...
| Kotva | ||||
|---|---|---|---|---|
|
...
- %HI_GetConnectedHBJ
- %HI_GetConnectedInstance
- %HI_SetConnectedObj - Zmena pripojeného objektu
- %HI_GetOBJURL
- %HI_SetOBJURL
Poznámka:
- Funkcie, ktoré začínajú menom %HI_Get... nadobúdajú hodnotu a je ich možné používať vo výrazoch.
- Ostatné funkcie sú tzv. riadiace funkcie.
...