Reference to the object of Graph, Report, Picture or Browser type.
Note: If the parameter is non-associated alias, ESL script generates an error Range Error (exceeding of the limits).
instanceNr
Number of instance.
Note: If the number of instance is negative, the D2000 HI process generate an error Range Error (exceeding of the limits).
Description
The function changes the connected object for displayers of the Graph, Report, Picture or Browser type. The displayer is characterized by the parameter refId. The parameter refToObj determines the object to be connected. The parameter instanceNr is the instance number, with which the object will be opened.
For the Browser displayer, there can be connected only Structured variable (SV.*) or Database table (DB.*). When changing the connected object, the modification of data in Browser displayer is ignored. It may be found by the function %HI_GetBrowserModifyFlag.
Return value of the function is the function success. The function can be used either as Control or as normal. The function execution will be terminated after execution of the initialisation part of the opened subpicture.
BOOL _bOk
_bOk := %HI_SetConnectedObj(_Trend, S.Picture\HBJ, 1)
IF _bOK THEN
; picture is opened
ELSE
; failure in opening the picture
ENDIF
where: _Trend - is RefId of the displayer of Trend type. T.Temperatures - object of Graph type. The expression T.Temperatures\HBJ is HBJ type (reference to object) The instance number is 0. S.Picture - object of Picture type.
Add Comment