%HI_GetOwnerHBJ function

Function
The function returns the unique identifier (HOBJ) of the picture which the current picture is inserted as a subpicture to.
Declaration
HBJ %HI_GetOwnerHBJ(
   [BOOL in bPhysical := True]
 )
Parameters
bPhysicalIf the value of parameter is True, the function returns a basic HOBJ of the picture which the current picture is inserted to.
If the value of parameter is False, the function returns a dynamic (unique) HOBJ of the instance picture which the current picture is inserted to.
Description
If the picture is not opened as a subpicture, the return value is 0.
Example
ENTRY btn_OnClick
 _ownerHBJ :=  %HI_GetOwnerHBJ()
 _ownerInstance :=  %HI_GetOwnerInstance()
 CALL [(_ownerHBJ)] Entry(_i) SYNC  ON  _FROM_HIP INSTANCE _ownerInstance
 _i := _i + 1
 END btn_OnClick

There is called the RPC procedure Entry of the picture, that contains current picture as a subpicture.

Note 1
See also %HI_GetOwnerInstance.
Note 2
 This function exists also in the %HIX_ version. It enables to find out HBJ also from other pictures than the current subpicture. HIX function works unless the picture, addressed via [hobj, instanceId], contains ESL script.

Related pages:

Active picture manipulation functions
Function arguments - types

Napíšte komentár