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.
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)