Akcia COPYOBJECT

Akcia vytvorí kópiu daného objektu.

COPYOBJECT

srcObject, newNameStr, aliasNewObject

srcObject	in	Odkaz na objekt.
newNameStr	in	Identifikátor hodnoty typu Text.
aliasNewObject	out	Identifikátor - kde bude vložený odkaz na novovzniknutý objekt.

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.

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