%HI_GetMetadata, %HI_SetMetadata functions

Function
%HI_GetMetadata function gets back (according to the defined key) text value of metadata which is assigned to a graphic object.
%HI_SetMetadata function sets (according to the defined key) a text value of metadata which is assigned to a graphic object. 
Declaration
TEXT %HI_GetMetadata(
   INT in _refId,
  TEXT in _key 
 )
 
 BOOL  %HI_SetMetadata(
  INT in _refId,
  TEXT in _key,
  TEXT in _value,
  BOOL in _bOverWrite 
 )
Parameters
_refIdReference to a graphic object (reference variable).
_keyKey which specified the metadata.
_valueNew value of the metadata.
_bOverWriteTRUE - either metadata are inserted (if they do not exist) or the value of existing metadata is updated.
FALSE - either metadata are inserted (if metadata do not exist) or the existing value of metadata is kept.
Description
%HI_GetMetadata gets back (according to the set key) text value of metadata which is assigned to graphic object.
%HI_SetMetadata sets new metadata to the graphic object according to defined key.
Note 1
Configuration of metadata for graphic object.

%HI_SetMetadata function applies the change of metadata only on the running instance of picture.
Note 2
These functions are available also in the %HIX_ version.

Related pages:

Graphic object manipulation functions
Function arguments - types

Napíšte komentár