Funkcia %To_String

Starý názov funkcie
%HI_To_String
Funkcia
Funkcia prevedie zadanú hodnotu na text podľa Stavového textu, Systémového textu a Transformačnej palety (pozri kapitolu Spôsoby zobrazovania hodnôt v systéme D2000) a výsledný text automaticky preloží cez Slovník podľa zadaného jazyka.

Funkciu je možné použiť aj v skripte servera (objekt typu Event).
Deklarácia
TEXT %To_String(
          in hodnota,
   [, HBJ in refToStatusText
   [, INT in transPalIdx
   [, INT in lngIdx]]]
 )

Parametre
hodnota Výraz, ktorého výsledná hodnota bude prevedená na text.
refToStatusText Nepovinný parameter - odkaz na objekt typu Stavový text.
transPalIdx Nepovinný parameter - index do Transformačnej palety.
lngIdx Nepovinný parameter - index jazyka v Slovníku.

Návratová hodnota
Návratová hodnota je typu Text.
Poznámka
Parameter refToStatusText musí byť odkaz na existujúci objekt typu Stavový text alebo hodnota 0. Hodnota 0 sa zadáva v prípade, že potrebujeme zadať index do transformačnej palety, ale stavový text nechceme použiť.

Parameter transPalIdx je platný v rozsahu 1..16. Ak nadobudne hodnotu mimo tento rozsah, parameter sa nepoužije.

Parameter lngIdx je platný v rozsahu definovaných jazykov v slovníku. Ak nadobudne hodnotu mimo tento rozsah, parameter nadobudne hodnotu preddefinovaného jazyka.

Druhý a tretí parameter musia byť platné hodnoty. Ak nie sú tieto podmienky splnené, funkcia vracia neplatnú hodnotu.


Príklad
 TEXT _text
 INT _value
 
 _value := 1
 ; prevod podľa konfigurácie stavového textu SText a indexu do Transformačnej palety
 _text := %To_String(_value, SText\HBJ, 1)
 
 ; prevod podľa indexu do Transformačnej palety
 _text := %To_String(_value, 0, 1)
 
 ; prevod podľa konfigurácie stavového textu SText
 _text := %To_String(_value, StavovyText\HBJ)
 
 ; prevod podľa ID jazyka
 _text := %To_String(_value,0, 0, 2)

Funkcie pre ovládanie aktívnej schémy
Rozšírené funkcie ESL
Argumenty funkcie - typy