Akcia COPYOBJECT

Funkcia
Akcia vytvorí kópiu daného objektu.
Deklarácia
COPYOBJECT
srcObject, newNameStr, aliasNewObject
Parametre
srcObject in Odkaz na objekt.
newNameStr in Identifikátor hodnoty typu Text.
aliasNewObject out Identifikátor - kde bude vložený odkaz na novovzniknutý objekt.

Popis
Zdrojový (vzorový objekt) môže byť objekt len objekt typu Graf. Akcia tento skopíruje pod novým menom, ktoré je dané parametrom newNameStr. Nové meno musí vyhovovať pravidlám pre meno objektu v D2000. Zlé meno generuje chybu _ERR_RANGE_ERROR.
Po úspešnom vytvorení nového objektu je do parametra aliasNewObject vložený odkaz na novovzniknutý objekt.
Poznámka
V kontexte aktívnej schémy akcia umožňuje vytvoriť dočasnú kópiu objektu, ak parameter newNameStr je prázdny reťazec. Kópia zaniká zatvorením aktívnej schémy, v rámci ktorej bola volaná akcia COPYOBJECT, alebo zatvorením skopírovaného objektu.
Dočasná kópia má význam v prípade, že nie je potrebné uchovávať kópiu objektu v konfigurácii aplikácie. Systém D2000 automaticky zabezpečí ich zmazanie, ak nie sú naďalej používané.
Príklad
Príklad predpokladá existenciu objektu D.Graf typu Graf.
 
 ALIAS _newObject

 COPYOBJECT D.Graf, "D.GrafCopy", _newObject
 ; Test úspechu akcie
 IF _newObject\HBJ = 0 THEN
   ; Kópia grafu sa nevytvorila
 ELSE
   ; Kópia grafu je hotová
   ; Otvorím ju v procese D2000 HI
 OPEN _newObject ON WS_PC.HIP
 ENDIF

Súvisiace stránky:

Akcie v skriptoch

Napíšte komentár