%HBJToStr function

Function
The function returns the name of the D2000 system object specified by its unique identifier (HOBJ).
Declaration
TEXT %HBJToStr(
   HBJ in objID
 )

Parameters
objID Value of HBJ or INT types.

Description
The function sends a query to the process D2000 Server to detect the name of the D2000 system object defined by the parameter objID. If the object doesn't exist or the parameter is an invalid value, the function returns invalid value.
Example
INT _hbj
 TEXT _name
 
 ; HOBJ of the object Sec
 _hbj := %StrToHBJ("Sec")
 
 _name := %HBJToStr(_hbj)    ; variable _name will contain the value of Sec
 _name := %HBJToStr(Sec\HBJ) ; variable _name will contain the value of Sec, too
 
 ; object probably doesn't exist => _hbj is invalid value
 _hbj := %StrToHBJ("qwerty")

Related pages:

ESL extended functions
Function arguments - types

Napíšte komentár