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